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全 球 知名 软件 架构 独立 咨询 师 、 讲 师 ， 创 
办 了 专门 讨论 软件 架构 问题 的 网 站 “编码 
架构 ” ( codingthearchitecture.com ) 。 
他 自称 是 写 代 码 的 软件 架构 师 和 明白 架构 
的 软件 开发 者 。 自 2008 年 以 来 的 7 年 时 间 
里 ，Simon 在 全 球 28 个 国家 做 过 有 关 软 件 
架构 、 技 术 领 导 力 及 其 与 敏捷 的 平衡 等 主 
题 的 百 余 场 演讲 ， 并 于 2012 年 8 月 在 中 国 
ArchSummit 全 球 架构 师 峰会 上 以 “ 郁 闽 的 
架构 师 ” 和 “如 何 设计 安全 的 架构 ”为 主 
题 发 表演 讲 ， 深 受 与 会 者 好 评 。Simon 已 
为 全 球 20 多 个 国家 的 软件 团队 提供 咨询 和 
培训 ， 他 的 客户 既 有 小 型 技术 初创 企业 ， 
也 不 乏 全 球 家 喻 户 晓 的 品牌 公司 。 


误 打 误 撞 进入 IT 行业 的 80 后 程序 员 ， 爱 好 
Web 技 术 ， 对 前 端 技术 尤其 偏爱 。 曾 在 盛大 
创新 院 担任 前 端 工程 师 ， 现 在 是 IBM 上 海 的 
一 名 软件 用 户 界 面 工程 师 。 除 了 具体 的 技 
术 ， 对 软件 架构 、 软 件 工程 也 很 感 兴趣 ,， 希 
望 把 自己 在 IBM 所 见 所 闻 分 享 出 来 ， 为 前 端 
领域 如 火 如 茶 的 工程 化 浪潮 贡献 力量 。 
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推荐 序 一 : 架构 师 真正 要 学 会 的 事情 


1. 要 学 会 去 看 ， 然 后 芯 掉 


有 一 本 书 叫 《 观 止 》 写 的 是 微软 研发 Windows NT 的 一 段 故事 。“ 观 止 ” 在 这 里 的 意思 是 说 
“看 到 这 些 ， 就 无 需 再 看 了 ”， 因 为 世上 之 物 亦 无 过 于 此 。20 多 年 过 去 ， 如 今 微软 在 操作 系统 上 
面临 着 的 种 种 挑战 与 困境 ， 其 实 与 《 观 止 》 所 和 叙 的 研发 方法 、 理 念 与 目标 有 着 与 生 俱 来 的 血缘 
关系 。 


男 一 个 与 “看 ”相关 的 词汇 是 “所 见 即 可 得 ”( WYSIWYG )。 这 个 词 以 及 与 此 相关 的 WIMP 
( Windows, Icon, Menu and Pointer ) 曾经 主导 了 整个 人 机 交互 的 设计 理念 。 也 是 在 20 多 年 前 ， 
Borland 为 Windows 桌面 系统 成 功 地 设计 了 路 语言 的 VCL， 由 此 “所 见 即 所 得 ”成 为 Borland 对 
“如 何 更 便捷 地 构建 UI” 的 基本 假想 ,以 至 于 这 家 伟大 的 公司 在 互联 网 时 代 来 临时 决定 “用 VCL 
描述 界面 的 方式 来 解决 “网 站 设计 ”的 问题 ( RadPHP 》。 


然而 ,互联 网 上 的 网 页 是 没有 WIMP 的 ; 移动 设备 上 的 操作 系统 也 不 再 采用 与 Windows NT 
类 似 的 方式 开发 。 


Borland 当时 盛大 的 一 个 Delphi 圈子 发 起 了 一 
次 “缅怀 活动 "， 组 织 者 说 :“ 爱 民 ， 你 应 该 会 为 那个 时 代 写 点 什么 吧 ? ” 


我 在 那个 缅怀 网 页 上 写 下 了 五 个 字 : 所 见 即 所 碍 。 


2. 要 学 会 去 听 ， 然 后 忘掉 


我 通常 说 架构 是 一 种 能 力 , 架构 角色 则 是 要 求 你 在 具体 事务 中 行使 某 些 行为 ,而 架构 师 则 是 
用 来 标识 这 些 能 力 与 行为 的 一 个 职务 。 


当 一 些 人 将 个 人 成 长 定义 为 “职业 发 展 ” 时 ， 就 表现 为 “怎样 成 为 架构 师 ” 这 样 的 问题 。 对 
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此 有 三 种 解决 方案 ， 第 一 种 是 印 一 张 写 着 这 样 头 衔 的 名 片 ， 而 “是 与 不 是 ”架构 师 并 不 重要 ; 第 
二 种 是 直接 和 否定 这 个 职务 的 意义 ， 比 如 声称 敏捷 天 生 就 是 反 架 构 的 ,于 是 “架构 师 ” 变 成 了 要 打 
倒 的 对 象 ， 所 以 成 不 成 为 这 个 将 被 打倒 的 对 象 也 就 不 重要 了 ; 第 三 种 则 干脆 声称 “人 人 都 是 架构 
师 ”， 既然 人 人 都 是 了 ， 那 么 “如 何 成 为 ”也 自然 就 不 重要 了 。 


我 们 大 多 数 人 都 具有 架构 的 能 力 , 并 且 也 或 多 或 少 地 行使 某 些 架构 角色 的 行为 , 唯一 缺乏 的 
是 一 个 叫做 “架构 师 ” 的 头衔 而 已 。 问 题 出 在 我 们 总 是 期 望 别人 通过 这 样 的 头衔 来 认可 自己 。 
是 我 们 为 自己 贴 上 这 样 或 那样 的 标签 , 然后 跟 别 人 持 有 的 同 种 标签 去 比 对 , 期 求 出 现 一 致 或 找 
出 某 种 差别 。 于 是 我 们 听 到 种 种 声音 : 某 某 某 真 的 是 /不 是 、 像 /不 像 架构 师 ; 如 果 是 架构 师 ， 那 
就 要 这 样 那样 ， 以 及 怎样 怎样 ; 其 实 这 个 架构 、 这 样 的 架构 ， 或 某 种 架构 应 该 怎么 做 ; 以 及 架 
构 是 什么 ， 架构 师 是 什么 ,等 等 。 回 顾 “ 三 种 解决 方案 "， 仍 是 困 在 这 样 的 认可 求 同 之 中 ， 与 之 
在 做 着 种 种 斗争 罢了 。 


其 实 不 单 是 你 的 所 见 阻碍 了 你 自己 ， 你 还 被 别人 的 所 见 阻碍 着 。 


并 


二 枚 
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3. 要 学 会 去 做 ， 然 后 志 掉 


朋友 跟 我 聊 他 家 的 两 岁 小 孩 : 我 刚 把 桌子 收拾 好 , 一 转眼 杯子 碗 筷 什 么 的 都 全 摔 地 上 了 。 我 
问 :“ 怎 么 了 ? ”他 说 :“ 小 孩子 什么 也 不 懂 啊 ， 她 看 到 桌布 觉得 喜欢 ， 就 一 把 抓 过 去 ……” 


小 孩子 没 能 看 到 桌子 上 还 有 杯子 ,但 正 因为 他 们 的 视线 里 没有 杯子 ,他们 的 行动 才 简 单 直 接 ， 
才 直 达 需 求 , 才 迅速 。 而 我 们 的 眼睛 里 有 杯子 、 桌 子 、 桌 布 等 一 切 , 我 们 经 年 累 月 地 维护 着 其 中 
的 次 序 与 关系 直到 这 些 东 西 混成 一 体 , 然后 我 们 便 日 日 坐 守 在 它们 的 面前 , 而 又 无 觉 他 们 的 存在 。 


正 是 我 们 自己 不 知 不 觉 地 设 定 了 这 些 事物 之 间 的 界线 , 并 把 这 些 界限 、 层 次 与 逻辑 井然 的 东 
西 称 为 “系统 ”。 当 我 们 从 那些 无 序 的 事物 中 识别 出 了 这 样 的 “系统 ”并 用 一 些 概念 、 名 词 去 定 
义 了 它们 之 后 , 我 们 对 此 的 一 切 知识 也 就 固化 了 。 当 这 种 秩序 被 建立 起 来 之 后 ,我 们 也 就 得 到 了 
对 有 序 和 无 序 (没有 你 所 设 定 的 “这 种 秩序 ”) 价值 的 识别 与 肯 否 ; 当 我 们 设 定 了 种 种 价值 、 观 
念 、 观 察 与 系统 的 模型 概念 之 后 ， 也 就 完成 了 这 个 系统 的 架构 。 


但 这 一 过 程 , 包括 完成 这 一 架构 一 一 它 可 以 命名 为 “世界 观 ” 一 一 的 方法 以 及 结果 , 在 本 质 
上 不 过 是 让 你 从 一 个 格子 跳 到 了 男 一 个 格子 而 已 。 我 们 处 在 种 种 界限 之 中 , 再 也 无 法 回 到 两 岁 小 
孩 的 、 一 切 无 得 的 视角 : 在 那个 视角 下 ,根本 就 没有 所 谓 的 界线 。 你 之 所 以 时 时 在 寻求 跨 界 ,其 
实 是 源 自 你 假设 了 “存在 界线 ”， 这 就 如 同 全 栈 的 含义 其 实 是 “没有 栈 "， 而 当 有 人 信心 满 满 地 要 
“成 为 全 栈 工 程 师 ” 时 ， 他 的 眼 里 便 又 有 个 “这 个 栈 ” 的 存在 。 
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所 谓 跨 界 不 是 指 你 能 力 与 方法 上 的 变化 ， 你 的 作为 取决 于 你 的 格局 ， 你 的 格局 取决 于 你 的 
所 见 。 


4. 要 学 会 超越 


架构 师 需要 超越 自己 与 别人 的 所 见 ， 因 为 你 观察 与 架构 的 对 象 称 为 “系统 ”， 你 看 到 系统 多 
少 的 真相 ,决定 了 你 用 怎样 的 影像 去 表现 它 ， 并 进而 推进 与 实现 这 种 影像 ， 亦 即 是 架构 。 我 们 既 
已 知道 的 、 理 解 的 、 明白 的 , 形成 了 我 们 的 知识 与 行为 的 一 切 , 却 也 正 是 阻碍 着 我 们 前 进 的 东西 。 
这 些 障碍 正 是 你 以 为 你 最 珍视 的 、 最 不 可 放弃 的 、 最 鲜血 淅 沥 体验 过 的 那些 经 验 与 成 就 。 在 这 些 
所 得 与 所 得 中 挣扎 与 决策 ， 就 是 架构 师 的 全 部 职责 。 因 此 作为 架构 师 ， 你 需要 能 够 超越 自己 对 系 
统 的 既 有 认识 , 看 到 你 在 光明 中 一 一 显而易见 之 处 一 一 所 未 见 的 , 这 是 你 驱动 系统 架构 进化 的 主 
要 动力 。 


所 以 架构 中 最 难 超越 的 并 不 是 某 个 大 师 或 前 辈 , 而 是 你 以 及 你 为 自己 所 作 的 设 定 。 当 你 设 定 
了 “架构 师 ” 这 个 目标 , 便 设 定 了 这 个 目标 所 表达 的 某 种 影像 ( 角色 )， 你 最 终 可 能 变 得 跟 这 个 
影像 完全 一 致 一 一 成 为 所 谓 的 “真正 的 架构 师 ”， 但 你 仍 不 过 是 困 周 于 对 这 个 “角色 ”的 一 个 假 
设 / 设 定 而 已 。 唯 一 破局 的 方法 是 : 超越 别人 对 某 个 角色 的 定义 ， 将 自己 做 成 这 个 角色 。 


至 此 ， 你 是 否 还 在 这 个 角色 之 中 ， 就 是 你 的 觉悟 了 。 


现任 豌豆 英 架 构 师 
前 盛大 网 络 平台 架构 师 、 支 付 宝 业 务 架构 师 


推荐 序 二 


说 起 架构 ,想必 很 多 人 会 认为 它 离 自己 太 远 , 我 做 的 事情 还 远 到 不 了 架构 这 么 高 的 层次 。 那 
么 什么 是 架构 呢 ?” 正 如 本 书 作者 所 做 的 调查 一 样 ， 不 同 的 人 会 给 出 不 同 的 见解 。 


我 们 不 妨 从 平时 的 项 目 中 来 观察 一 下 , 技术 选 型 是 怎么 出 来 的 ?团队 的 分 工 协作 是 如 何 进 行 
的 ? 项 目 质量 和 进度 是 怎么 得 到 保障 的 ? 


是 的 ,你 会 发 现 ， 在 任何 一 个 项 目 中 ,总 有 些 人 会 在 这 些 事情 上 付出 努力 。 从 他 们 身上 可 以 
看 到 哪些 不 一 样 的 特质 ? 他 们 看 起 来 都 很 积极 , 好 像 整 个 项 目 就 是 他 们 在 负责 ; 他 们 让 事情 得 到 
解决 ， 最 终 让 项 目 得 以 交付 。 


可 以 认为 , 项 目 中 出 现 的 类 似 行 为 都 是 在 对 架构 的 思考 , 思考 架构 会 是 从 被 动 服务 到 主动 服 
务 的 Owner 意识 养 成 过 程 ， 会 让 我 们 Get things done! 而 最 终 完成 的 好 坏 及 是 否 有 方法 论 支撑 则 
是 另外 讨论 的 范畴 ， 这 也 正 是 本 书 要 为 大 家 呈现 的 内 容 ! 


如 果 你 刚 接触 项 目 不 久 ， 建议 由 浅 入 深 , 从 分 清楚 什么 是 库 什么 是 框架 开始 ， 带 着 问题 在 本 
书 中 寻找 答案 ! 如 果 你 已 经 验 丰富 ， 同 样 可 以 认真 思考 书 中 每 一 部 分 后 面 的 问题 进行 自我 对 照 ， 
看 看 与 作者 的 建议 是 否 有 共鸣 之 处 ! 


区 


从 现在 开始 ， 认 真 且 有 效 地 去 规划 完成 自己 负责 的 事 


杜 欢 
淘宝 网 高 级 技术 专家 
2012 年 如 入 淘宝 ， 曾 就 职 于 雅虎 台湾 及 CISCO 


译 者 序 2.0 


在 本 书 行将 出 版 之 时 读 到 周 爱 民 老 师 写 的 推荐 序 , 感触 良 多 。 因 而 书 还 未 面世 , 译 者 序 就 写 
了 第 二 稿 ， 倒 也 跟 开行 业 的 风格 挺 契 合 : 很 多 软件 首次 发 布 时 的 版 本 号 都 是 2.0， 甚 至 更 高 。 


初 识 软件 架构 


我 是 从 一 个 小 互联 网 公司 走出 来 的 野生 程序 员 。 小 公司 里 没有 很 细 的 分 工 , 程序 员 必须 像 万 
金 油 ， 什 么 都 会 一 点 。 数 据 怎么 分 表 ， 后 端 接 口 怎 么 分 ，URL 结构 怎么 定 ， 前 后 端 怎 么 接 ， 这 
些 都 得 搞定 。 事 情 多 了 ， 必 须 想 清楚 。 


我 在 成 大 创新 院 做 的 最 后 一 个 项 目 是 一 个 OS 垂直 社交 应 用 。 两 个 同事 合作 开发 10S 客户 端 ， 
而 我 在 这 个 项 目 里 的 工作 是 开发 一 个 REST 架构 的 数据 服务 。 需 求 很 简单 ， 就 是 根据 客户 端的 应 
用 场景 编写 一 整套 API。 当 第 一 个 里 程 碑 的 所 有 工作 完成 之 后 ,我 发 现 需求 开发 只 占用 了 一 小 部 
分 时 间 , 而 设计 关系 型 数据 库 的 结构 , 设计 认证 、 授权 和 报告 , 设计 应 用 签名 和 令 牌 , 设计 REST 
风格 的 URL 结构 ， 开 发 API 调试 工具 , 编写 API 文档 , 这 些 事 情 却 耗 费 了 大 量 的 时 间 。 我 就 想 ， 
花 了 这 么 多 时 间 做 这 些 事情 ,并 没有 增加 任何 功能 ， 又 感觉 不 能 不 做 , 这 到 底 是 为 什么 ?对 这 个 
问题 的 思考 和 学 习 ， 应 该 算是 我 对 软件 架构 的 入 门 。 


怎么 会 翻译 这 本 书 


两 年 前 我 进入 IBM, 参与 的 项 目 是 一 个 适用 于 大 型 数据 中 心 的 存储 资源 管理 工具 。 这 个 工具 
的 规模 和 复杂 程度 远 远 超 出 大 多 数 面向 普通 用 户 的 互联 网 应 用 , 自然 对 架构 的 要 求 更 为 严 厅 。 而 
IBM 作为 一 家 传统 软件 企业 , 深厚 的 技术 积累 也 令 我 大 开眼 界 , 给 了 我 很 多 学 习 和 思考 软件 架构 
的 机 会 和 资源 。 


我 们 项 目的 架构 师 会 贡献 代码 ， 会 参加 代码 评审 /回顾 ; 我 们 有 预先 架构 设计 ， 也 有 架构 演 
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化 ; 我 们 执行 SCRUM 方法 ; 任何 人 对 设计 有 意见 ， 都 可 以 给 架构 师 发 邮件 ， 只 要 有 理 有 据 ， 就 
能 说 服 他 更 改 设计 。 在 此 之 前 我 从 未 见 过 这 样 奇 特 的 组 合 。 很 快 适应 了 以 后 , 我 义 想 , 这 么 好 的 
方式 ， 届 然 只 有 我 们 在 用 ? 直到 今年 三 月 ， 在 微 博 上 看 到 图 灵 的 李 松 峰 老 师 为 Sofiware 
Architecture for Developers 一 书 征 召 译 者 。 读 过 样 章 后 才 发 现 ， 我 们 就 是 作者 理想 中 的 团队 啊 ! 
既然 如 此 ， 何 不 尝试 翻译 这 本 书 ? 


染 构 离 我 们 并 不 遥远 


写 给 程序 员 的 软件 架构 , 这 是 一 个 很 有 趣 的 出 发 点 。 长 久 以 来 , 架构 师 在 程序 员 群 体 中 声名 
狼藉 ,软件 架构 被 很 多 人 认为 是 一 项 脱离 现实 、 高 高 在 上 的 工作 。 其 实 对 程序 员 来 说 ， 架 构 近 在 
眼前 ! 下 至 接口 设计 ， 上 至 技术 选 型 ,不 论 你 是 否 意识 到 ， 每 个 程序 员 或 多 或 少 都 接触 和 参与 过 
一 些 架构 工作 。 架 构 师 也 自然 而 然 成 为 相当 一 部 分 程序 员 的 职业 发 展 方向 : 你 看 , 我 们 努力 想 要 
成 为 自己 吕 吕 的 人 。 


本 书 的 作者 是 一 位 经 验 丰富 的 架构 师 。 他 从 最 简单 的 基本 概念 人 手 , 对 软件 架构 进行 了 层 层 
深入 的 细致 讲解 ,结合 自己 的 实践 经 验 ， 总 结 出 很 多 实用 的 准则 和 方法 ,并 且 附 上 一 个 完整 的 开 
源 项 目 来 对 这 些 内 容 加 以 佐证 ,帮助 读者 学 习 和 理解 。 翻 译 这 本 书 , 在 我 看 来 更 是 对 软件 架构 的 
一 次 系统 学 习 , 不 仅 丰富 了 我 对 软件 架构 的 理解 , 更 改变 了 我 对 架构 师 这 个 角色 的 一 些 固 有 印象 。 
这 本 书 令 我 获 益 菲 浅 ,希望 更 多 有 志 成 为 架构 师 的 程序 员 朋 友 也 能 从 中 有 所 收获 。 


周 爱 民 老师 的 序 


十 一 假期 结束 后 打开 邮箱 , 收 到 图 灵 的 李 静 老师 的 邮件 , 得 知 周 爱 民 老 师 会 为 这 本 书 撰写 推 
荐 序 。 惊 喜 ， 因 为 爱民 老师 是 包括 我 在 内 的 很 多 人 敬仰 的 资深 前 辈 。 悍 恐 ， 因 为 我 在 软件 架构 方 
面 还 是 个 菜鸟 ， 写 作 能 力 更 与 爱民 老师 相去 其 远 。 


要 来 爱民 老师 的 文章 一 读 ,“ 然 后 忘掉 ”， 写 得 真 好 ! 我 从 未 受过 任何 计算 机 科学 或 软件 工程 
的 专业 训练 ， 大 学 所 学 的 化 学 专业 也 跟 计算 机 毫 无 关联 。 因 此 ， 去 看 去 听 去 做 ， 并 且 牢 牢记 住 ， 
使 我 得 以 在 这 个 行业 一 步 步 走 到 今天 。 自 从 对 软件 架构 产生 兴趣 ， 也 是 如 此 逐渐 学 到 很 多 概念 、 
方法 。 虽 然 清楚 架构 必 有 权衡 ， 不 能 十 全 十 美 ， 然 而 了 解 的 知识 越 多 ， 就 更 想 面面俱到 ， 反 而 放 
不 开 。 殊 不 知 ， 补 牢记 住 ， 也 给 自己 画 地 为 牢 ， 陷 入 爱民 老师 所 说 的 困 局 。 


如 果 说 这 本 书 帮 我 画 了 一 个 更 大 的 圈 , 那么 爱民 老师 的 文字 则 告诫 我 要 跳出 这 个 圈 。 我 面前 
的 架构 之 路 还 很 长 ， 不 知 何 时 能 走出 圈 外 ， 走 到 爱民 老师 今日 所 处 之 地 。 
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谢谢 你 们 


这 本 书 的 翻译 能 够 完成 , 我 最 想 感 谢 的 人 是 成 都 七 中 的 高 中 语文 老师 王 正 可 。 王 老师 是 我 近 
20 年 学 生生 涯 中 最 重要 的 一 位 老师 : 她 是 第 一 个 让 我 对 语文 产生 兴趣 的 人 。 王 老师 教 给 我 文字 
的 艺术 ,帮助 我 找到 阅读 和 写作 的 乐趣 ,对 我 而 言 这 是 一 笔 巨 大 的 财富 。 如 果 不 兽 有 幸 成 为 她 的 
学 生 ， 我 想 我 不 会 养 成 写作 的 习惯 ， 更 不 可 能 有 翻译 图 书 的 想法 。 


为 了 让 我 能 够 安心 地 翻译 , 家 里 的 领导 承担 了 洗衣 、 做 饭 、 扫 地 ( 以 及 数 钱 ) 等 繁琐 的 家 务 。 
对 一 些 难以 理解 的 字句 ,她 也 和 我 一 起 讨论 。 作 为 一 个 非 球 迷 , 她 还 陪 我 熬夜 观看 了 好 多 场 世界 
杯 比 赛 , 大 大 减轻 了 我 因为 拖延 翻译 而 产生 的 负 罪 感 。 图 灵 公司 的 李 松 峰 和 李 静 两 位 老师 ， 对 我 
翻译 这 本 书 给 予 了 极 大 的 肯定 和 支持 , 并 且 纵容 了 我 逾期 未 完工 的 行为 。 这 本 书 也 有 他 们 的 一 份 
付出 。 


2014 年 10 月 于 上 海 
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信息 技术 行业 不 是 大 步 前 行 ， 就 是 剧烈 动荡 。 一 方面 , 我 们 奋力 前 行 , 重新 发 明 软件 构建 方 
式 , 时 时 处 处 精益 求 精 。 而 男 一 方面 ,我们 不 断 遗 忘 过 去 的 好 处 ,软件 开发 团队 常 意 想 不 到 地 把 
事情 搞 砸 。 


软件 架构 在 一 个 成 功 的 软件 交付 中 扮演 关键 角色 , 然而 令 人 肖 形 的 是 , 很 多 团队 都 忽视 了 这 
一 点 。 即 使 在 最 敏捷 的 团队 中 ,软件 构架 这 一 角色 也 都 是 必需 的 , 不管 是 由 一 个 人 还 是 整个 团队 
共同 扮演 , 但 要 寻求 到 预先 和 演化 两 种 构架 理念 的 平衡 , 往往 还 只 是 人 们 美好 的 意愿 而 并 没有 变 
为 现实 。 


软件 架构 的 坏 名 声 


当 我 介绍 自己 是 软件 架构 师 时 ， 对 方 通常 会 有 两 种 反应 。 要 么 觉得 这 非常 酷 ， 想 了 解 更 多 ; 
要 么 就 是 露出 不 悄 的 神情 ,意思 是 说 “我 想 跟 实际 开发 软件 的 人 聊 ， 而 不 是 跟 只 会 画 框框 线 线 的 
指挥 家 聊 ”。 软 件 架 构 的 角色 在 开行 业 中 和 名声 很 差 ， 出 现 这 种 想法 自然 不 难 理解 。 


“软件 架构 ”给 人 的 印象 通常 是 架构 师 闭门造车 ， 提 前 做 好 大 型 预先 设计 ， 然 后 好 像 接力 赛 
跑 时 传递 交接 棱 一 样 ， 把 庞大 的 UML ( Unified Modeling Language， 统 一 建 模 语言 ) 模型 或 200 
页 Word 文档 丢 给 毫 不 知情 的 开发 团队 。 当 然 ， 这 是 假设 架构 师 实际 参与 了 软件 设计 。 似 乎 很 多 
人 都 认为 ， 只 要 做 一 个 PPT， 而 且 幻 灯 片 中 有 一 页 出 现 了 “企业 服务 总 线 ” 框 线 图 ， 就 算是 做 完 
了 软件 设计 。 哦 , 千 万 别 忘 了 ， 这 个 PPT 里 毫 无 疑问 也 少不了 对 ROI ( Return on Investment， 投 
资 回报 ) 和 TCO ( Total Cost of Ownership ， 总 体 拥有 成 本 ) 的 陈述 。 


很 多 组 织 对 软件 开发 普遍 都 有 一 个 有 意思 的 看 法 。 比 如 , 他们 看 到 了 离 岸 外 包 可 以 节省 成 本 ， 
因而 把 软件 开发 流程 中 的 编码 工作 也 看 作 一 种 可 以 买卖 的 商品 。 其 结果 往往 是 本 地 开发 者 被 推 向 
所 谓 “高 价值 ”的 软件 架构 职位 ， 而 编码 则 交 由 其 他 人 完成 。 多 数 情况 下 这 只 会 让 软件 架构 和 开 
发 更 加 脱节 , 还 常常 让 人 像 赶 鸭子 上 架 一 样 不 得 不 去 承担 架构 工作 。 这些 组 织 也 常 倾向 于 把 架构 
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师 看 作 一 种 职位 级 别 而 非 工作 角色 。 


敏捷 愿景 


“敏捷 ”已 经 出 现 了 差不多 十 年 ,但 它 仍 是 “外 来 的 时 变 小 子 "”。 很 多 软件 团队 都 有 “实现 敏 
捷 ” 的 愿景 。 毫 无 疑问 ， 敏 捷 有 很 多 好 处 ， 人 们 都 想 让 你 相信 它 是 灵丹妙药 ， 但 事实 并 非 如 此 。 
IT 行业 的 每 件 事 ， 都 伴随 着 铺天盖地 的 宣传 和 天 花 乱 坠 的 炒作 。 如 今 ， 开 始 一 个 新 的 软件 项 目 ， 
总 能 听 到 自 组 织 的 团队 、 自 动 化 验收 测试 、 持 续 交 付 、 回 顾 、 看 板 、 浮 现 式 设计 ， 还 有 一 大 堆 你 
可 能 都 没 听 过 的 新 名 词 。 这 很 奇 酷 , 但 团队 往往 急于 赶 时 艇 , 就 将 原来 的 东西 不 分 好 坏 一 起 丢掉 。 
“ 非 功 能 需求 ” 听 起 来 虽然 不 酷 ， 但 这 并 不 是 你 能 忽视 它们 的 理由 。 


这 堆 老 古董 软件 架构 的 东西 都 是 什么 ? 很 多 软件 团队 似乎 认为 他 们 不 需要 软件 架构 师 , 张口 
闭口 都 是 “ 自 组 织 团队 ”、“YAGNI”( You Aren't Going to Need It， 你 不 会 需要 它 ) “演化 架构 ” 
和 “最 后 责任 时 刻 ” 这 些 词 。 如 果 他 们 确实 需要 架构 师 ， 也 许 会 去 找 个 “敏捷 架构 师 ”。 我 不 完 
全 确定 这 些 词 都 是 什么 意思 ， 但 我 猜 它 有 点 像 用 便利 贴 替 代 UML, 或 用 TDD ( Test-Driven 
Development， 测 试 驱动 开发 ) 奉 代 画图 。 也 就 是 说 ， 假 设 他 们 已 经 不 是 只 使 用 高 层次 系统 隐喻 
的 概念 ， 而 且 也 不 把 “浮现 式 设计 ”作为 盲目 乐观 的 借口 。 


那么 你 党 得 自己 是 架构 师 吗 


看 起 来 这 个 行业 里 有 很 多 人 上 自称 是 软件 架构 师 ， 而 他 们 实际 上 完全 在 做 别 的 事 。 我 能 够 原 该 
那些 在 大 企业 里 实践 软件 架构 ， 却 误 以 为 自己 是 “企业 架构 师 ” 的 人 。 总 之 我 们 这 行 的 术语 就 是 
经 常 把 人 搞 糊 涂 。 


但 那些 夸大 自己 在 软件 团队 里 作用 的 人 又 如 何 呢 ? 这 些 不 负责 任 的 架构 师 通 常 担任 技术 领 
导 , 却 连 基 本 能 力 都 不 够 格 。 我 见 过 一 些 面向 公众 的 网 站 在 进入 用 户 验收 测试 环境 时 ,还 有 一 堆 
安全 问题 ， 没 有 基本 性 能 测试 ， 常用 功能 也 有 问题 ， 死 链 ， 并 且 完 全 没有 文档 。 这 只 是 我 能 看 到 
的 软件 外 在 的 问题 ,天 知道 代码 会 是 什么 样子 ! 如 果 你 承担 了 软件 架构 的 角色 ， 最 后 却 交 付 这 样 
的 东西 ， 你 做 得 就 不 对 。 这 不 是 什么 软件 架构 ， 这 也 只 能 算是 盲目 乐观 。 


失意 的 染 构 师 


必须 承认 , 不 是 所 有 软件 团队 都 像 这 样 ,但 我 前 面 讲 的 也 不 
确实 就 是 这 样 干 的 ， 因 此 软件 架构 有 这 样 的 名 声 并 不 奇怪 。 
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。 糟糕 的 是 很 多 组 织 
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想 在 这 个 行业 里 有 所 作为 ,就 需要 克制 对 新 鲜 玩意 的 迷恋 ,开始 问 一 些 问 题 。 敏捷 需要 染 构 
吗 , 或 者 架构 真 的 需要 敏捷 吗 ? 相 比 近 些 年 学 到 的 东西 , 我 们 是 不 是 忘掉 了 更 多 好 的 软件 设计 方 
法 ?对 于 我 们 现在 构建 的 软件 系统 , 只 有 盲目 乐观 就 够 了 吗 ? 如 果 我 们 不 是 从 培养 未 来 软件 架构 
师 的 角度 考虑 ， 这 些 问题 还 有 意义 吗 ? 我 们 要 如 何 从 失意 走向 平和 ? 


关于 本 书 


这 是 一 本 强调 实践 、 注 重 实效 、 轻 量 级 、 面 向 开发 者 的 软件 架构 指南 。 你 将 从 中 学 到 : 


口 软件 架构 的 本 质 ; 

口 为 什么 软件 架构 角色 应 当 包含 编码 、 指 导 与 合作 ; 
口 开始 编码 前 真正 需要 思考 的 事情 ; 

口 如 何 用 简单 的 草图 让 你 的 软件 架构 可 视 化 ; 

口 为 软件 生成 文档 的 轻 量 方法 ; 

口 为 什么 敏捷 和 架构 并 不 冲突 ; 

口 “ 恰 如 其 分 ”的 预先 设计 是 什么 意思 ; 
口 如 何 通 过 风险 风暴 来 识别 风险 。 


这 部 短文 集 推倒 了 传统 的 象牙 塔 , 模糊 了 软件 开发 和 架构 在 流程 中 的 界限 , 将 教会 你 软件 架 
构 、 技 术 领 导 力 以 及 它们 与 敏捷 之 间 的 平衡 。 


本 书写 作 初 表 

跟 很 多 人 一 样 ， 我 的 职业 生涯 从 软件 开发 开始 ， 从 前 辈 那 里 得 到 指导 ， 和 团队 一 起 工作 , 交 
付 软件 系统 。 久 而 久之 , 我 也 开始 设计 软件 系统 中 的 一 小 部 分 ,最 后 我 的 职务 变 成 了 这 样 : 承担 
我 现在 认为 是 设计 软件 架构 的 任务 。 


我 的 职业 生涯 多 数 是 为 IT 咨询 机 构 工作 ， 这 意味 着 我 参与 过 的 大 多 数 项 目 要 么 是 为 客户 构 
架 软 件 系统 ， 要么 是 和 客户 一 起 完成 构建 。IT 咨询 机 构 要 发 展 壮 大 ,就 需要 更 多 的 人 和 团队 。 要 
组 建 更 多 团队 ， 又 需要 更 多 的 软件 架构 师 。 这 就 是 我 写 这 本 书 的 理由 。 


(1) 软件 架构 应 该 容易 理解 。 第 一 次 设计 软件 架构 时 ， 尽 管 有 一 些 优 秀 的 导师 ， 但 我 还 是 搞 
不 清 自己 该 干 些 什么 。 的 确 ， 有 很 多 软件 架构 方面 的 书籍 ,但 它们 的 写作 视角 不 一 样 。 我 发 现 其 
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中 大 多 数 都 偏 研究 方向 ， 甚 至 完全 是 学 术 派 ， 而 我 是 一 个 寻求 现实 建议 的 软件 开发 者 。 我 想 写 一 
本 对 我 职业 生涯 的 那个 阶段 有 用 的 书 ， 即 面向 软件 开发 者 的 软件 架构 书 。 


(2) 所 有 软件 项 目 都 需要 架构 。 我 真心 喜欢 敏捷 方法 ， 但 其 中 很 多 方法 缺乏 对 软件 架构 的 明 
确 重视 ， 这 让 我 如 坐 针 秆 。 敏 捷 方 法 不 是 说 不 应 该 做 任何 预先 设计 , 但 它们 通常 也 不 明确 探讨 这 
一 点 。 我 发 现 这 会 让 人 们 得 出 错误 的 结论 ,我 也 看 到 了 缺乏 预先 思考 可 能 造成 的 后 果 。 我 非常 清 
楚 大 型 预先 设计 也 不 能 解决 问题 。 我 感觉 适当 地 做 一 些 预先 思考 能 提供 一 种 愉快 的 中 间 状 态 ,而 
这 特别 适合 与 不 同 经 验 和 背景 的 团队 一 起 工作 的 情形 。 我 更 喜欢 轻 量 的 软件 架构 方法 , 这样 我 就 
可 以 尽早 让 一 些 结构 单元 到 位 ， 从 而 提高 成 功率 。 


(3) 传播 轻 量 级 软件 架构 实践 。 这 些 年 我 学 习 和 实践 了 很 多 对 设计 软件 架构 很 有 帮助 的 做 法 。 
这 些 实践 涉及 软件 设计 流程 , 并 通过 发 现 技术 风险 来 沟通 和 记录 软件 架构 。 我 总 是 认为 这 些 实践 
都 合理 ， 但 情况 并 非 如 此 。 过 去 几 年 ， 我 向 上 千 人 教授 这 些 实践 ， 并 见证 了 他 们 的 变化 。 写 书 可 
以 帮助 我 把 这 些 想 法 传递 给 更 多 人 ， 和 希望 其 他 人 也 能 从 中 受益 。 


软件 开发 的 新 方法 


这 本 书 不 谈 创 造 软件 开发 的 新 方法 。 传统 软件 开发 经 常会 过 度 地 预先 思考 ,而 初次 接触 敏捷 
方法 的 团队 往往 又 缺乏 架构 思维 , 本 书 就 是 想 要 在 这 两 者 之 间 找 到 一 个 很 好 的 平衡 点 。 最 终 要 告 
诉 大 家 ， 预 先 设计 与 演化 架构 是 可 以 共存 的 。 


关于 软件 架构 ， 每 个 开发 者 都 应 该 知道 的 五 件 事 
为 了 帮助 你 大 致 了 解 本 书 的 内 容 ， 这 里 有 每 个 开发 者 都 应 该 知道 的 五 件 有 关 软 件 架 构 的 事 。 
1. 软件 架构 不 是 大 型 预先 设计 


软件 架构 历来 被 认为 跟 大 型 预先 设计 和 瀑布 式 项 目 有 关 , 团队 要 周全 地 考虑 软件 设计 的 所 有 
细节 ， 然 后 才 开 始 编码 。 软 件 架构 就 是 关于 软件 系统 的 高 层次 结构 ， 以 及 你 如 何 理解 它 。 它 是 影 
响 软件 系统 形态 的 重要 决策 ， 而 非 理 解数 据 库 每 个 字段 应 该 有 多 长 。 


2. 每 个 软件 团队 都 需要 考虑 软件 架构 


不 论 产品 的 大 小 和 复杂 性 ， 每 个 软件 团队 都 需要 考虑 软件 架构 。 为 什么 ?简单 地 说 ， 尚 未 发 
生 的 坏事 往往 都 会 发 生 ! 如 果 软 件 架 构 是 关于 结构 和 愿景 的 ,不 考虑 这 一 点 就 可 能 产 出 结构 糟糕 、 


关于 本 书 xxi 


内 部 不 一 致 的 软件 系统 。 这 样 的 软件 系统 难以 理解 和 维护 , 很 可 能 无 法 满足 一 些 重 要 的 非 功能 需 
求 ， 比 如 性 能 、 可 伸缩 性 或 安全 性 。 明 确 地 考虑 软件 架构 ， 提 供 了 一 种 引入 技术 领导 的 方式 ， 增 
加 成 功 交 付 的 胜算 也 对 你 有 益 。 


3. 软件 架构 的 角色 关乎 编码 、 指 导 和 合作 


很 多 人 对 软件 架构 师 的 印象 还 很 老 套 ,以 为 就 是 “象牙 塔 软件 架构 师 向 毫 不 知情 的 开发 团 
队 面 授 机 宜 。 其 实 并 非 如 此 ， 因 为 现代 软件 建构 更 倾向 于 成 为 一 种 有 利于 编码 、 指 导 和 协同 设计 
的 方法 。 软 件 架 构 的 角色 不 一 定 要 由 一 个 人 来 承担 , 而 且 要 了 解 得 到 的 架构 是 否 确实 行 得 通 ， 编 
码 是 非常 好 的 方式 。 


4. 无 需 使 用 UML 


同样 地 ， 传 统 观点 还 以 为 软件 架构 就 是 试图 捕捉 每 一 个 细节 的 庞大 UML 模型 。 创 造 和 交流 
共同 的 愿景 很 重要 , 然而 你 不 见得 需要 使 用 UML。 实际 上 , 可 以 说 UML 并 不 是 一 个 交流 软件 架 
构 的 好 方法 。 如 果 要 保留 一 些 简单 的 指导 方针 ， 轻 量 级 “ 框 线 ” 风 格 的 草图 是 一 个 交流 软件 架构 
的 有 效 方式 。 


5. 好 的 软件 架构 是 支持 敏捷 开发 的 


有 一 种 普遍 的 误解 ， 认 为 “架构 ”和 “敏捷 ”之 间 是 矛盾 的 。 但 恰恰 相反 ， 好 的 软件 架构 是 
支持 敏捷 的 ， 可 以 帮助 你 拥抱 并 实现 变化 。 然 而 好 的 软件 架构 并 非 与 生 俱 来 ,需要 你 努力 争取 。 


在 微 博 上 分 享 这 本 书 


请 帮 Simon Brown 在 新 浪 微 博 上 宣传 这 本 书 。 


推荐 本 书 的 微 博 以 # 程 序 员 必 读 之 软件 架构 # 开 头 。 


点 击 下 面 这 个 链接 ， 在 新 浪 微 博 上 搜索 其 他 人 对 本 书 的 评价 : 


http:/huati.weibo.comy/k/ 程 序 员 必 读 之 软件 架构 


软件 架构 培训 


我 开设 了 一 个 一 到 两 天 的 培训 课程 ， 进行 实用 的 轻 量 级 软件 架构 指导 , 这 个 课程 涵盖 了 本 书 
全 部 内 容 。 你 将 学 到 : 


口 软件 架构 的 本 质 ; 

口 为 什么 软件 架构 角色 应 当 包含 编码 、 指 导 与 合作 ; 
口 开始 编码 前 真正 需要 思考 的 事情 ; 

口 如 何 用 简单 的 草图 可 视 化 软件 架构 ; 

口 为 软件 生成 文档 的 轻 量 方法 ; 

口 为 什么 敏捷 和 架构 并 不 冲突 ; 

口 “恰如其分 ”的 预先 设计 是 什么 意思 ; 


口 如 何 通过 风险 风暴 来 识别 风险 。 


我 将 向 你 教授 软件 架构 、 技 术 领 
导 力 以 及 它们 与 敏捷 之 间 的 平衡 。 我 
在 2013 年 软件 架构 师 大 会 上 所 做 的 演 
讲 “Software Architecture & the balance 
with agility” 的 视频 http://Vimeo.com/ 

user22258446/review/79382531/914679 

30a4 是 对 本 课程 内 容 很 好 的 概述 。 我 
的 课程 和 专题 研讨 已 在 欧洲 、 中 东 和 
美国 等 20 多 个 国家 开展 。 


你 可 以 选择 授课 方式 ， 包 括 让 我 
去 你 们 办 公 室 进行 内 训 。 了 解 更 多 细节 ， 请 访问 http://www.codingthearchitecture.com/training/ 或 
发 邮件 至 simon.brown@codingthearchitecture.com。 


什么 是 软件 染 构 


通过 学 习 这 部 分 ,我 们 将 了 解 软 件 架构 是 什么 ， 
架构 和 设计 的 区 别 ， 敏 捷 的 架构 意味 着 什么 ， 以 及 为 


什么 思考 软件 架构 很 重要 。 


第 1 章 


什么 是 染 构 


在 不 同 的 人 眼 里 “架构 ”一 词 的 意思 大 相 径 庭 ， 
年 里 我 问 过 上 百人 同一 个 问题 ， 在 他 们 看 来 “架构 " 


分 先后 ): 


口 模块 、 连 接 、 依 赖 和 接口 ; 
口 大 局 观 ; 

口 改变 成 本 很 高 的 事 ' 
口 难以 改变 的 事情 ; 
口 更 加 兼顾 全 局 的 设计 ; 

口 接口 而 非 实现 ; 

口 审美 (比如 : 艺术 般 的 整洁 代码 ); 
口 概念 模型 ; 

口 满足 非 功能 需求 /质量 属性 ; 
口 每 件 事 都 有 “架构 ”; 

口 沟通 能 力 ( 抽象 、 语 言 、 词 汇 ); 
口 计划 ; 

口 一 定 程 度 的 严格 和 可 靠 性 ; 


es 


月 ， 


ee 


口 蓝图 ; 
口 系统 、 子 系统 、 交 互 和 接口 ; 
口 管理 ; 


口 战略 决策 的 产 出 ; 


互联 网 上 对 架构 的 定义 也 多 如 牛 毛 。 过 去 几 
意味 着 什么 。 得 到 的 答案 概括 如 下 ( 排名 不 


口 必要 的 约束 ; 

口 结构 (组件 和 交互 ); 

口 技术 方向 ; 

口 战略 和 愿景 ; 

口 结构 单元 ; 

口 实现 目标 的 过 程 ; 

口 标准 和 准则 ; 

口 整个 系统 ; 

口 工具 和 方法 ; 

口 从 需求 到 最 终 产品 的 道路 ; 
口 指导 原则 ; 

口 技术 领导 力 ; 

口 构成 产品 的 元 素 之 间 的 关系 ; 
口 对 环境 约束 和 限制 的 意识 ; 
口 基础 ; 

口 抽象 的 观点 ; 

口 把 问题 化 整 为 零 的 过 程 ; 
口 产品 的 上 骨架、 支柱。 


难怪 找 不 到 一 个 合适 的 定义 ! 好 在 还 可 以 分 为 名 词 和 动词 两 大 类 。 无 论 我 们 谈论 的 是 建造 一 
个 物理 建筑 或 一 个 软件 系统 ， 都 适用 。 


作为 名 词 


架构 作为 名 词 来 解释 时 ， 概 括 起 来 都 与 结构 有 关 : 将 产品 分 解 为 一 系列 组 件 、 模 块 和 交互 。 
这 需要 考虑 整个 产品 , 包括 处 理 ( 建筑 物 的 ) 供电 、 供水、 空调 , 或 处 理 ( 软件 的 ) 安全 、 配 置 、 
错误 处 理 等 横 切 关注 点 的 基础 设施 服务 。 


作为 动词 


架构 作为 动词 来 解释 时 , 包括 了 理解 你 需要 构建 什么 、 设 定 愿 景 以 便于 进行 构建 和 做 出 恰当 
的 设计 决策 。 所 有 这 些 都 要 以 需求 为 基础 ， 因 为 需求 驱动 架构 。 关 键 在 于 ， 架 构 是 关于 交流 愿景 
以 及 引入 技术 领导 力 的 , 这 样 参与 构建 产品 的 每 个 人 都 能 理解 这 个 愿景 , 并 为 产品 的 成 功 做 出 积 
极 贡 献 。 


第 纪 章 
架构 的 种 类 


单 是 IT 行业 就 有 很 多 不 同 种 类 的 架构 和 架构 师 。 下 面 列 出 了 人 们 在 被 问 及 该 问题 时 给 出 的 
最 普遍 回答 ( 排名 不 分 先后 ): 
口 基础 设施 ; 
口 安全 ; 
口 技术 ; 
口 解决 方案 ; 
口 网 络 ; 
口 数据 ; 
口 硬件 ; 
口 企业 ; 
口 应 用 程序 ; 
口 系统 ; 
口 集成 ; 
口 IT; 
口 数据 库 ; 
D 信息 ; 
口 流程 ; 
口 商务 ; 
口 软件 。 


有 些 踪 憾 的 是 , 这 个 列表 中 的 有 些 词 , 特别 是 其 定义 相互 依赖 的 , 比 其 他 词 容易 定义 。 比 如 ， 
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“解决 方案 架构 ”到 底 是 什么 意思 ?对 一 些 组 织 来 说 ,“ 解 决 方案 架构 师 ” 就 是 “软件 架构 师 ”， 
而 有 些 组 织 则 有 一 个 特定 的 专注 于 整体 “方案 ”设计 (但 不 包括 实施 细节 的 讨论 ) 的 角色 。 类 似 
地 ,“ 技 术 架 构 ” 通 常 指 软件 、 人 硬件 ， 或 者 两 者 兼 有 。 


有 趣 的 是 ， 当 我 请 人 们 列 出 他 们 知道 的 开架 构 种 类 时 ,“ 软 件 架构 ”往往 是 最 后 被 提 及 的 。 
这 或 许 反映 了 这 个 词 带 给 人 们 的 困惑 。 


它们 的 共同 点 是 什么 


那么 ,， 所 有 这 些 词 有 什么 共同 点 呢 ? 除 了 都 以 “架构 ”或 “架构 师 ” 结 尾 之 外 ， 所 有 架构 类 
型 都 具有 结构 和 愿景 。 


以 “基础 设施 架构 ”为 例 , 想象 你 要 在 两 个 办 公 室 之 间 建 立 网 络 连接 ， 而 这 两 个 办 公 室 远 隔 
千里 。 一 种 做 法 是 找 一 卷 最 长 的 网 线 , 然后 从 一 个 办 公 室 直接 连接 到 男 一 个 办 公 室 。 假设 你 有 足 
够 的 线 绕 ， 这 可 能 行 得 通 ， 但 现实 中 为 了 达到 这 个 目标 ,你 要 考虑 很 多 环境 约束 和 非 功 能 特性 。 
这 就 是 架构 的 过 程 以 及 设 定 实现 目标 愿景 的 重要 之 处 。 


采用 一 条 很 长 的 线 缆 是 一 种 方法 ,但 由 于 现实 世界 的 约束 ,这 个 方法 并 不 可 行 。 因 为 这 个 原 
因 ， 网 络 往往 要 复杂 得 多 ， 需 要 一 组 协同 工作 的 组 件 来 满足 目标 。 那 么 从 基础 设施 的 角度 出 发 ， 
我 们 谈论 结构 时 你 期 望 看 到 的 是 这 一 领域 内 的 通用 组 件 ， 比 如 路 由 锅 、 防 火 墙 、 包 整形 需 、 交 换 
机 等 。 


不 管 你 是 构建 软件 系统 、 网 络 还 是 数据 库 , 任何 成 功 的 方案 都 需要 你 理解 问题 ， 并 设 定 一 个 
愿景 可 以 和 每 个 参与 构建 最 终 产品 的 人 沟通 。 不 论 何 种 领域 的 架构 ， 其 实 主要 就 是 结构 和 愿景 。 


第 .不 章 
软件 架构 是 什么 


乍 一 看 ,“ 软 件 架构 ”似乎 很 容易 定义 。 它 就 是 讲 软件 的 架构 ， 对 吧 ? 没 错 ， 但 它 并 不 局 限于 
软件 。 
应 用 程序 架构 


对 于 我 们 软件 开发 者 来 说 ,最 熟悉 的 应 该 是 应 用 程序 架构 ,特别 是 通常 由 单一 技术 编写 的 “应 
用 程序 ”( 比如 Java 网 络 应 用 程序 、Windows 桌面 应 用 程序 ， 等 等 )。 应 用 程序 架构 的 关注 点 是 
应 用 程序 ， 通 常 包括 将 应 用 程序 解构 为 类 和 组 件 ， 确 保 设 计 模式 的 正确 应 用 ,构建 或 使 用 框架 ， 
等 等 。 本 质 上 ， 应 用 程序 架构 谈论 的 是 软件 设计 的 低级 别 切面 ,通常 只 考虑 单一 的 技术 栈 ( 比如 
Java、 微 软 NET 等 )。 


结构 单元 主要 以 软件 为 基础 ， 包 括 编 程 语言 和 结构 、 类 库 、 框 架 、API 等。 它 由 类 、 组 件 、 
模块 、 函 数 、 设 计 模 式 等 加 以 描述 。 应 用 程序 架构 着 重 考虑 软件 和 代码 组 织 。 


系统 架构 


我 喜欢 把 系统 架构 看 作 是 更 大 规模 的 应 用 程序 架构 。 大 多 数 软 件 系统 实际 上 是 由 横 跨 不 同 层次 
和 技术 的 多 个 应 用 程序 组 成 。 举 个 例子 ， 你 可 能 有 这 样 一 个 软件 系统 ，Java EE 中 间 层 消费 Oracle 数 
据 库 提供 的 数据 ， 同 时 向 .NET Silverlight 客户 端 提供 Web 服务 。 每 个 部 分 都 有 自己 的 应 用 程序 架构 。 


要 让 整个 软件 系统 工作 起 来 , 就 要 思考 如 何 组 合 这 些 单独 的 应 用 程序 。 换 句 话 说 , 要 有 端 到 
端 软 件 系统 在 较 高 层次 上 的 整体 结构 。 另 外 ,大 多 数 软 件 系统 都 不 是 孤立 的 ,因此 系统 架构 还 关 
注 互 操作 性 和 与 环境 中 其 他 系统 的 集成 。 


结构 单元 就 是 各 种 软 硬 件 , 从 编程 语言 和 软件 框架 到 服务 器 和 基础 设施 。 跟 应 用 程序 架构 相 


比 , 系统 架构 描述 为 从 组 件 和 服务 到 子 系统 等 更 高 层次 的 抽象 。 系统 架构 的 定义 大 多 数 都 包括 了 
软件 和 硬件 。 毕 范 ， 一 个 成 功 的 软件 系统 离 不 开 硬件 ， 即 使 是 云 上 的 虚拟 硬件 。 


软件 架构 


应 用 程序 和 系统 架构 相对 较 容易 理解 , 但 人 们 对 “软件 架构 ”一 词 的 理解 不 尽 相 同 。 我 想 把 
软件 架构 定义 得 尽 可 能 简单 ， 而 不 去 受制 于 各 种 定义 的 复杂 性 和 细微 差别 。 对 我 而 言 ， 软件 结构 
就 是 应 用 程序 和 系统 架构 的 结合 。 


换 句 话说 ， 从 代码 结构 和 基础 到 将 代码 成 功 部 署 到 生产 环境 , 与 一 个 软件 系统 重要 元 素 相关 
的 所 有 东西 就 是 软件 架构 。 从 开发 者 的 角度 考虑 软件 开发 ， 关 注 点 多 数 会 放 在 代码 上 。 在 这 里 ， 
我 们 考虑 的 是 有 助 于 构架 更 好 软件 的 东西 ， 比 如 面向 对 象 的 原则 、 类 、 接 口 、 控 制 反 转 、 重 构 、 
自动 化 单元 测试 、 代 码 整洁 和 其 他 不 胜 枚 举 的 技术 实践 。 如 果 你 团队 里 的 人 都 只 考虑 这 些 , 那么 
谁 来 考虑 其 他 事情 ? 

口 横 切 关注 点 ， 比 如 登录 和 异常 处 理 ; 

口 安全 性 ， 包 括 认证 、 授 权 和 敏感 数据 保密 ; 

D 性 能 、 可 伸缩 性 、 可 用 性 和 其 他 质量 属性 ; 
口 审计 及 其 他 监管 需求 ; 

口 客观 环境 的 约束 ; 

D 互 操作 性 、 与 其 他 软件 系统 的 集成 

D 运营 、 支 持 和 维护 的 需求 ; 

D 结构 和 整个 代码 库 解决 问题 、 实 现 特性 的 方法 的 一 致 性 ; 
D 评估 正在 构建 的 基础 有 助 于 交付 按 计划 进行 。 

有 时 你 需要 退 一 步 ， 远 离 代码 和 你 的 开发 工具 。 这 并 不 意味 着 低层 次 的 细节 不 重要 ， 因 为 可 
用 的 软件 最 终 还 是 要 靠 交 付 可 运行 的 代码 。 细 节 同样 重要 ， 但 就 大 局 而 言 ,对 软件 的 整体 视角 可 
以 确保 你 的 代码 符合 整体 愿景 而 非 背 道 而 驰 。 


企业 架构 : 战略 而 非 代码 


企业 架构 一 般 是 指 整个 组 织 的 中 心 工作 , 着 眼 于 如 何 组 织 与 利用 人 员 、 流程 和 技术 来 使 企业 有 
效 和 高 效 地 工作 。 换 句 话 说 , 它 是 关于 企业 如 何 分 成 组 或 部 门 ， 业务 流程 如 何在 上 层 运作 ， 以 及 技 
术 如 何 支 撑 这 一 切 。 这 跟 软 件 架 构 形 成 了 强烈 对 比 ， 因 为 企业 架构 没有 必要 关注 技术 细节 。 相 反 ， 
企业 架构 可 能 看 重 的 是 如 何在 整个 组 织 中 最 好 地 利用 技术 ， 而 无 需 实际 介入 这 些 技术 的 工作 原理 。 

有 些 开发 者 和 软件 架构 师 把 企业 架构 看 作 职业 发 展 的 下 一 站 , 然而 大 多 数 人 却 并 非 如 此 。 从 
事 企 业 架构 工作 所 需要 的 思维 方式 和 软件 架构 大 相 径 庭 , 对 于 技术 及 其 在 组 织 中 的 应 用 , 视角 很 
不 一 样 。 企 业 架 构 需 要 更 高 层次 的 抽象 。 这 关乎 广度 而 非 深度 ， 关 乎 战略 而 非 代码 。 


第 承 章 
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以 我 的 经 验 ， 人们 用 “敏捷 ”一 词 指 代 的 往往 不 止 一 件 事情 。 首 当 其 冲 就 是 软件 开发 的 敏捷 
方法 "; 快速 行动 ， 拥 抱 变化 ， 持 续 交 付 ， 接 收 反馈 ， 不 一 而 足 。 与 敏捷 思维 模式 相关 的 第 二 个 
意思 是 ， 人 们 如 何在 敏捷 环境 中 一 起 工作 , 通常 包括 了 团队 动态 、 系 统 思 维 、 心 理学 以 及 其 他 可 
能 会 跟 创建 高 效 团队 联系 在 一 起 的 事情 。 


先 把 后 面 提 到 的 这 些 “ 上 肤浅 的 东西 ” 放 到 一 边 ， 在 我 看 来 ， 给 软件 架构 打上 “敏捷 ”的 标签 
就 意味 着 它 能 够 应 对 所 处 环境 中 的 变化 , 适应 人 们 提出 的 不 断 变化 的 需求 。 这 跟 敏 捷 团 队 创建 的 
软件 架构 不 尽 相 同 。 以 敏捷 方式 交付 软件 并 不 能 保证 得 到 的 软件 架构 是 敏捷 的 。 事实 上 ,以 我 的 
经 验 ， 发 生 相 反 的 事情 通常 是 因为 团队 更 关注 交付 功能 ， 而 非 架 构 。 


理解 “敏捷 


要 理解 你 的 软件 架构 需要 多 敏捷 ， 就 应 该 看 看 敏捷 究竟 是 什么 。 美 国 空军 战斗 机 飞行 员 约 
翰 ' 博 伊 德 ( John Boyd ) 提出 了 一 个 名 为 OODA 循环 的 概念 ?。 本 质 上 ， 这 个 循环 构成 了 基本 的 
决策 过 程 。 想 象 一 下 , 你 是 一 个 正 与 敌人 缠 斗 的 战斗 机 飞行 员 。 为 了 击败 对 手 , 你 需要 观察 情况 ， 
确定 自己 的 方位 〈 比 如 做 一 些 分 析 )， 决 定做 什么 ， 并 采取 行动 。 在 激烈 的 战斗 中 ， 为 避免 被 对 
手 击落 ， 这 个 循环 要 执行 得 尽 可 能 快 。 博 伊 德 说 ， 如 果 你 能 洞悉 对 手 的 OODA 循环 ， 执 行 得 比 
他 更 快 ， 就 能 混淆 视听 ， 误 导 对 手 。 如 果 你 比 对 手 更 敏捷 ， 就 能 成 为 最 后 的 赢家 。 


GD http://agilemanifesto.org 
@ http:/en.wikipedia.org/wikiOODA _loop 一 一 观察 、 定 向 、 决 策 和 行动 ，Observe、Orient、Decide 、Act。 
一 一 译 者 注 
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在 一 篇 题 为 “What Lessons Can the Agile Community Learn from A Maverick" Fighter Pilot”( 敏 
捷 社区 能 从 特 立 独 行 的 战斗 机 飞行 员 身 上 学 到 什么 ) ”的 论文 中 ， 不 列 颠 哥伦比亚 大 学 的 史 蒂 
夫 ' 阿道夫 引用 了 博 伊 德 的 概念 ,将 其 应 用 于 软件 开发 ， 得 出 的 结论 是 敏捷 是 相对 的 ， 且 按时 间 
来 衡量 。 如 果 你 的 软件 团队 交付 的 软件 跟 不 上 所 处 环境 的 变化 ， 就 不 算 敏 捷 。 如 果 你 在 一 个 庞大 
而 行动 缓慢 、 鲜 有 改变 的 组 织 中 工作 ， 很 可 能 交付 软件 要 花费 数 月 ， 却 仍 被 组 织 认 为 是 “敏捷 
的 ; 在 一 个 精益 初创 团队 中 ， 和 情况 多 半 就 不 一 样 了 。 


好 的 架构 带 来 敏捷 


产生 这 个 讨论 的 动力 是 好 的 软件 架构 能 带 来 敏捷 。 尽 管 面向 服务 的 架构 ( SOA”) 因为 过 于 
复杂 、 爱 肿 和 粗 燃 的 实现 而 被 一 些 组 织 看 作 脏 脏 的 词汇 ， 但 软件 系统 由 小 型 微服 务 * 构 成 仍 呈 一 
种 增长 趋势 , 每 个 服务 只 专注 做 好 一 件 事 。 一 个 微服 务 通常 可 能 不 到 100 行 代码 。 如 果 需 要 改变 ， 
服务 可 以 用 另 一 种 语言 重新 编写 。 这 种 架构 风格 以 多 种 方式 提供 了 敏捷 。 小 型 、 松 耦合 的 组 件 和 
服务 可 以 孤立 地 构建 、 修 改 和 测试 ,甚至 根据 需求 变化 移 除 和 替换 。 因 为 能 够 加 入 新 组 件 、 服 务 
并 在 需要 时 扩展 ， 这 种 架构 风格 也 很 适合 非常 灵活 和 可 适 配 的 部 署 模型 。 


然而 , 天 上 不 会 掉 馅 饼 。 构建 一 个 这 样 的 软件 系统 需要 时 间 、 精 力 和 准则 。 很 多 人 也 不 需要 
这 种 水 平 的 适应 性 和 敏捷 性 , 这 就 是 为 什么 你 看 到 那么 多 团队 构建 的 软件 系统 实际 上 整体 感 强 得 
多 , 各 部 分 捆绑 在 一 起 并 以 单一 单元 部 署 。 尽管 更 易于 构建 ,然而 这 种 架构 风格 在 面 对 变 化 的 需 
求 时 通常 要 花费 更 多 精力 去 适 配 ， 因 为 功能 往往 交织 在 代码 库 中 。 


在 我 看 来 ， 两 种 架构 风格 各 有 优 缺 点 , 应 该 在 权衡 利弊 之 后 ,再 决定 是 构架 一 个 整体 系统 还 
是 几 个 微 系 统 。 和 IT 行业 中 所 有 的 事情 一 样 ， 在 这 两 者 之 间 也 有 中 间 地 之 。 抱 着 实用 主义 的 想 
法 ,你 总 能 选择 构建 一 个 由 很 多 定义 好 的 小 组 件 构成 , 但 仍 作 为 单一 单元 部 署 的 软件 系统 。 这 也 
让 你 有 可 能 在 将 来 轻松 地 迁移 到 微服 务 架 构 。 


QD Maverick 是 电影 《壮志 凌云 》 中 汤姆 ， 克 鲁 斯 饰演 的 飞行 员 的 代号 。 一 一 译 者 注 
© http://ieeexplore.ieee.org/xpl/articleDetails.jsp?tp=&arnumber=1667567 
@) Service-Oriented Architecture,http://en.wikipedia.org/wiki/Service-oriented_architecture。 一 一 译 者 注 


由 http://www.infoq.com/presentations/Micro-Services 
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整体 架构 基于 服务 的 架构 

0 务 
(通常 是 单一 部 团 0 
单元 的 一 团 乱 麻 ) | 


不 同 的 软件 架构 提供 不 同 层次 的 敏捷 


你 需要 有 多 敏捷 


理解 组 织 或 业务 变化 的 速度 很 重要 , 因为 这 能 帮助 你 决定 采用 何 种 架构 风格 , 可 能 是 整体 架 
构 、 微 服务 架构 或 者 介 于 两 者 之 间 。 要 理解 这 种 权衡 并 做 出 相应 的 选择 。 敏 捷 不 是 日 来 的 。 
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如 果 架 构 是 关于 结构 和 愿景 的 , 那 设 计 又 是 什么 ”如 果 你 在 创建 一 个 解决 问题 的 方案 , 这 不 
就 是 设计 吗 ? 如 果 确 实 如 此 ， 那 设计 和 架构 有 什么 区 别 ? 


找 出 区 别 


对 于 架构 和 设计 的 区 别 ， 格 雷 迪 … 布 奇 (Grady Booch ) 有 一 个 常 被 引用 的 定义 ， 可 以 很 好 
地 回答 这 个 问题 。 在 On Design 一 文中 ， 他 说 道 : 


作为 名 词 ， 设 计 是 指 一 个 系统 内 命名 的 (尽管 有 时 无 法 命名 ) 结构 或 行为 ， 解 决 或 
有 助 于 解决 该 系统 的 一 个 或 多 个 问题 。 因 而 设计 代表 了 潜在 的 决策 空间 中 的 一 个 点 。 


思考 任何 一 个 需要 解决 的 问题 , 可 能 都 有 101 种 方法 。 以 你 目前 的 软件 项 目 为 例 , 要 实现 同 
一 目标 ,可 能 有 多 种 不 同 的 技术 、 部 署 平台 和 设计 方法 可 选 。 即 使 是 设计 软件 系统 ， 你 的 团队 也 
只 是 从 潜在 决策 空间 里 的 很 多 个 点 中 选择 一 个 。 


格雷 迪 还 说 : 
所 有 架构 都 是 设计 ， 但 并 非 所 有 设计 都 是 架构 。 


这 很 有 道理 ， 因 为 创建 一 个 解决 方案 本 质 上 就 是 一 次 设计 练习 。 然而 ,出 于 某 些 原因 ， 有 一 
个 区 别 使 得 并 非 所 有 设计 都 是 “架构 ”"， 对 此 他 声明 : 


Qa 原文 给 出 的 链接 http:/www.handbookofsoftwarearchitecture.com/index.jsp?page=Blog&part=2006 已 失效 ， 可 访问 
https:/www.ibm.com/developerworks/community/blogs/gradybooch/entry/on_design?lang=en> 阅 读 文章 。 译 者 注 
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架构 反映 了 使 一 个 系统 成 型 的 重要 设计 决策 ， 而 重要 性 则 通过 改变 的 成 本 来 衡量 。 


从 本 质 上 讲 ， 格 雷 迪 认为 重要 决策 即 “架构 ”， 其 他 的 都 是 “设计 ”。 在 现实 世界 中 ,架构 和 
设计 的 区 别 并 不 明显 , 但 该 定义 确实 为 我 们 提供 了 一 个 基准 , 去 思考 在 我 们 的 软件 系统 中 哪些 可 
能 是 重要 的 (或 者 说 “架构 的 ”)。 比 如 说 ， 这 可 能 包括 : 


口 系统 的 形态 (例如 , 客户 端 - 服务 器 、 基 于 Web、 原 生 移动 客户 端 、 分 布 式 、 异 步 , 等 等 ); 
口 软件 系统 的 结构 ( 例如 ,组件 、 层 、 交 互 ， 等 等 ); 

口 技术 选择 〈 即 编程 语言 、 部 署 平台 ， 等 等 广 

口 框架 选择 〈 例 如，Web MVC "框架 、 持 久 性 /ORM'? 框架 ， 等 等 ); 

口 设计 方法 /模式 选择 〈 例如 ， 针 对 性 能 、 可 伸缩 性 、 可 用 性 等 的 方法 )。 


架构 决策 不 可 能 轻易 反悔 , 那 会 大 费 周章 。 或 者 说 直 白 点 ,架构 决策 很 难 在 一 个 下 午 就 完成 
重 构 。 
理解 意义 


后 退 一 步 想 想 哪些 对 你 的 软件 系统 很 重要 ,这 往往 是 值得 的 。 例如, 很 多 团队 使 用 关系 型 数 
据 库 ,这 个 选择 可 能 被 认为 很 重要 。 为 了 减少 在 数据 库 技术 变化 时 必要 的 返工 量 , 很 多 团队 会 使 
用 Hibernate 或 Entity Framework 这 样 的 ORM 框架 。 引 入 额外 的 ORM 层 使 得 数据 库 操作 能 与 代 
码 的 其 他 部 分 解 耘 ， 而 且 理 论 上 ， 不 用 花费 很 多 精力 就 能 独立 地 切换 数据 库 。 


引入 额外 层 的 决策 是 将 某 个 部 分 从 软件 系统 中 解 耦 的 经 典 技术 , 促进 了 低 耦 合 、 高 内 聚 和 更 
好 的 关注 点 分 离 。 此 外 , 有 了 ORM 以 后 , 可 能 一 个 下 午 就 完成 了 数据 库 的 切换 。 从 这 一 点 来 说 ， 
从 架构 上 它 不 会 再 被 看 作 是 重要 的 。 


然而 ， 当 数据 库 的 选择 可 能 不 再 被 当 作 重 要 决策 时 , 通过 引入 额外 层 实 现 解 耦 就 应 该 是 重要 
决策 。 如 果 你 想 知 道 为 什么 ， 试 想 把 你 当前 所 用 的 ORM 或 Web MVC 框架 完全 替换 成 男 一 个 ， 
要 花 多 长 时 间 。 当 然 ， 你 可 以 在 所 选 的 ORM 上 再 添加 其 他 层 ， 以 隔离 业务 逻辑 ， 并 提供 轻松 蔡 
换 ORM 的 敏捷 性 。 但 是 ， 你 又 做 出 了 另 一 个 重要 决策 : 引入 了 额外 的 分 层 、 复 杂 性 和 成 本 。 


尽管 “重要 决策 ” 没 法 彻底 消失 , 但 能 通过 架构 分 层 等 多 种 策略 来 改变 。 软 件 系统 架构 流程 
的 一 部 分 就 是 搞 清 楚 哪些 是 重要 的 及 为 什么 。 


GD Model-View-Controller， 模 型 - 视图 - 控制 器 。 一 一 译 者 注 
@@ Object-Relational Mapping， 对 象 关系 映射 。 一 一 译 者 注 
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那么 , 软件 架构 重要 吗 ? 敏捷 和 软件 工艺 运动 帮助 提升 了 我 们 构建 的 软件 系统 的 品质 , 这 非 
常 好 。 它们 一 起 帮助 我 们 在 并 导管 理 时 间 和 预算 限制 的 同时 , 写 出 更 好 、 更 能 满足 业务 需求 的 软 
件 。 但 是 我 们 能 做 得 更 多 ， 因 为 即使 是 少量 的 软件 架构 ， 也 能 帮助 预防 项 目的 很 多 问题 。 成 功 的 
软件 项 目 不 仅仅 是 好 的 代码 ， 有 时 候 你 要 暂时 跳出 代码 ， 总 览 大 局 。 


缺乏 软件 架构 将 引发 问题 


既然 软件 架构 是 关于 结构 和 愿景 的 ， 那 你 可 以 说 它 总 是 存在 的 。 我 同意 , 确实 如 此 。 说 了 这 
么 多 ,显而易见 ,不 思考 软件 架构 ( 以 及 “大 局 ”) 会 导致 团队 经 常 遭 遇 一 些 常见 问题 。 问 问 你 
自己 下 面 这 些 问 题 : 


口 你 的 软件 系统 有 良好 定义 的 结构 吗 ? 

口 团队 里 每 个 人 都 以 一 致 的 方式 实现 特性 吗 ? 
口 代码 库 的 质量 水 平一 致 吗 ? 

口 对 于 如 何 构建 软件 ， 团 队 有 共同 的 愿景 吗 ? 
口 团队 里 每 个 人 都 得 到 了 足够 的 技术 指导 吗 ? 
口 有 适当 的 技术 领导 力 吗 ? 


如 果 上 面 某 些 问题 的 答案 是 “不 ”， 那 就 需要 很 好 的 团队 和 很 好 的 运气 才 可 能 成 功 地 交付 一 
个 软件 项 目 。 如 果 没 人 思考 软件 架构 ， 最 终结 果 往 往 看 起 来 像 一 团 乱 麻 (big ball of mud ) "。 当 


GD http://www.laputan.org/mud/ 
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然 , 会 有 一 个 结构 , 但 不 是 你 想 要 的 ! 其 他 副作用 还 包括 软件 系统 大 慢 、 不 安全 、 脆 弱 、 不 稳定 、 
难以 部 署 、 难 以 维护 、 难 以 改变 、 难 以 扩展 ， 等 等 。 我 敢 肯 定 你 从 没 见 过 或 参与 过 这 样 的 软件 项 
目 ， 对 吗 ? 你 没有 ， 我 也 没有 。 


既然 软件 架构 是 每 个 软件 系统 都 固有 的 ， 那 我 们 为 什么 不 干脆 承认 这 一 点 ， 放 一 些 心思 在 
上 面 ? 
软件 架构 的 好 处 


思考 软件 架构 能 带 来 哪些 好 处 ? 总 绪 如 下 : 


口 让 团队 跟随 一 个 清晰 的 愿景 和 路 线 图 ， 无 论 这 个 愿景 是 一 人 所 有 还 是 整个 团队 共有 ; 

口 技术 领导 力 和 更 好 的 协调 ; 

口 与 人 交流 的 刺激 因素 ， 以 便 回 答 与 重要 决策 、 非 功能 需求 、 限 制 和 其 他 横 切 关注 点 相关 
的 问题 ; 

口 识别 和 减轻 风险 的 框架 ; 

口 方法 和 标准 的 一 致 性 ， 随 之 而 来 的 结构 良好 的 代码 库 ; 

口 正在 构建 的 产品 的 坚实 基础 ; 

口 对 不 同 的 听众 ， 以 不 同 层次 的 抽象 来 交流 解决 方案 的 结构 。 


所 有 软件 项 目 都 需要 软件 架构 吗 


我 不 会 给 出 “看 情况 ”这 种 典型 的 咨询 式 回答 ,相反 我 会 说 答案 毫 无 疑问 是 肯定 的 并 提醒 
每 个 软件 项 目 都 应 该 考虑 多 种 因素 ， 以 评估 必需 多 少 软件 架构 的 思考 。 这 些 包括 了 项 目 /产品 的 
大 小 、 项 目 /产品 的 复杂 性 、 团 队 的 大 小 和 团队 的 经 验 。 对 于 多 少 是 “刚刚 好 ”， 将 在 本 书 其 他 部 
分 探讨 。 


(1) 你 知道 “架构 ”都 说 些 什么 吗 ? 你 所 在 团队 的 其 他 人 知道 吗 ? 你 所 在 组 织 的 其 他 人 呢 ? 

(2) IT 领域 有 很 多 不 同类 型 的 架构 。 它 们 有 什么 共同 之 处 ? 

(3) 你 和 团队 对 “软件 架构 ”的 含义 有 一 个 标准 定义 吗 ? 你 能 够 轻松 地 向 团队 的 新 成 员 解释 
吗 ? 这 个 定义 在 你 所 在 组 织 通 用 吗 ? 

(4) 如 果 用 “敏捷 ”来 描述 一 个 软件 的 架构 ， 是 什么 意思 ? 你 如 何 面向 “敏捷 ”进行 设计 ? 

(5) 你 能 够 把 你 当前 软件 项 目 所 做 的 架构 决策 列 一 个 清单 吗 ? 它们 被 视 为 重要 的 原因 明显 吗 ? 

(6) 如果 从 代码 后 退 一 步 ， 你 的 软件 系统 的 “大 局 ”中 包含 了 哪些 事情 ? 

(7) 你 所 在 组 织 的 技术 职业 发 展 怎么 样 ? 企业 架构 会 是 你 的 出 路 吗 ? 

(8) 软件 架构 重要 吗 ? 为 什么 ， 好 处 是 什么 ? 你 的 软件 项 目的 架构 足够 吗 ? 还 是 太 多 了 ? 


软件 架构 的 角色 


这 部 分 将 天 注 软件 架构 的 角色 ， 包 括 软 件 架 构 的 
名 是 什么 ， 需 要 哪 类 技能 ， 以 及 为 什么 编码 、 指 导 


和 合作 很 重要 。 


第 CO 阐 
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要 成 为 一 名 软件 架构 师 , 绝 非 一 夜 之 间或 一 次 晋升 那么 简单 。 这 是 一 个 角色 ， 而 不 是 一 个 级 
别 。 这 是 一 个 循序 渐进 的 过 程 ， 你 会 逐渐 获得 这 个 角色 所 需 的 经 验 和 信心 。“ 软 件 开发 者 ”这 个 
词 很 容易 理解 ， 而 “软件 架构 师 ” 则 不 然 。 下 面 是 我 认为 构成 软件 架构 角色 应 有 的 内 容 。 注 意 ， 
我 这 里 说 的 是 “角色 ”; 它 可 以 是 一 个 人 ,也 可 以 由 团队 共同 扮演 。 


架构 驱动 力 设计 软件 技术 风险 
理解 目标 ;， 抓 住 、 提 | | 建立 技术 战略 、 愿 景 | | 发 现 、 减 轻 和 承担 技 
炼 、 挑 战 需求 和 限制 和 路 线 图 术 风险 ， 保 证 架构 的 


“运转 » 


架构 演化 编写 代码 质量 保证 
贯穿 整个 软件 交付 过 付 的 3 引入 并 坚持 标准 、 指 
程 ， 持 续 的 技术 领导 导 、 原 则 等 
和 对 架构 的 承担 


软件 以 构 
角色 


1. 架构 驱动 力 
这 个 角色 首先 要 理解 业务 目标 和 管理 架构 驱动 力 , 其 中 包括 需求 ( 功能 性 需求 和 非 功能 性 需 
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求 ) 和 环境 的 限制 。 软 件 项 目 经 常 纠缠 于 询问 用 户 需 要 什么 功能 ， 却 很 少 问 他 们 有 哪些 非 功能 性 
需求 (或 质量 属性 )。 有 时 候 利益 相关 者 会 告诉 我 们 “系统 一 定 要 快 "， 这 太 主 观 了 。 非 功能 性 需 
求 和 限制 往往 对 软件 架构 有 巨大 的 影响 , 因此 明确 地 将 其 纳入 软件 架构 的 角色 , 可 以 保证 它们 被 
考虑 到 。 


2. 设计 软件 


设计 软件 的 过 程 是 软件 架构 角色 的 一 部 分 , 这 一 点 应 该 在 意料 之 中 。 这 涉及 要 理解 如 何 解决 
架构 驱动 力 带 来 的 问题 , 创建 软件 系统 的 整体 结构 ， 并 为 交付 设 定 一 个 愿景 。 不 管 你 想 做 到 多 敏 
捷 , 你 可 能 都 需要 花 一 些 时 间 去 明确 思考 架构 要 如 何 解 决 利益 相关 者 提出 的 问题 , 因为 你 的 软件 
系统 自己 搞 不 定 它 们 。 


软件 设计 的 一 个 关键 部 分 是 技术 选择 , 这 通常 是 一 个 有 趣 的 练习 , 但 也 有 一 定 的 挑战 。 例如 ， 
有 些 组 织 有 一 份 允许 使 用 的 技术 清单 ,你 只 能 从 中 选择 , 有 些 组 织 则 规定 不 允许 使 用 特定 许可 的 
开源 技术 。 接 下 来 是 其 他 所 有 因素 ， 比 如 成 本 、 许 可 、 供 应 商 关 系 、 技 术 战 略 、 兼 容 性 、 互 操作 
性 、 支 持 、 不 熟 、 升 级 策略 、 最 终 用 户 环 境 ， 等 等 。 这些 因素 掺 杂 在 一 起 ， 常 常会 把 选择 一 个 富 
客户 端 技术 之 类 的 简单 决策 彻底 搞 成 一 场 辟 梦 。 需 要 有 人 负责 这 个 技术 选择 的 过 程 , 这 完全 属于 
软件 架构 角色 的 职责 范围 。 


3. 技术 风险 


到 目前 为 止 的 内 容 可 以 帮 你 专注 于 构建 好 的 解决 方案 , 但 并 不 能 保证 成 功 。 把 最 好 的 设计 和 
最 好 的 技术 简单 地 拼凑 在 一 起 ,并 不 意味 着 整个 架构 就 会 成 功 。 你 选择 的 技术 是 否 真 的 奏效 ， 也 
是 个 问题 。 很 多 团队 都 有 “做 不 如 买 ”的 战略 ， 为 了 可 能 会 节约 成 本 而 去 使 用 一 些 ( 商业 或 开源 
的 ) 产品 。 然 而 ， 很 多 团队 也 因为 听信 供应 商 网 站 或 西装 革履 的 销售 人 员 的 宣传 ， 结 果 遭 了 珊 。 
似乎 很 少 人 会 问 技术 是 否 真 的 以 设想 的 方式 工作 ， 能 证 明 的 人 更 少 。 


技术 选择 其 实 就 是 风险 管理 , 当 复 杂 度 或 不 确定 性 高 的 时 候 降 低 风险 ,有 利 可 图 时 再 冒 点 险 。 
所 有 的 技术 决策 , 在 做 出 选择 时 都 要 把 全 部 因素 考虑 在 内 ， 这 些 技术 决策 也 需要 评审 和 评估 。 这 
可 能 包括 一 个 软件 系统 所 有 的 主要 结构 单元 ， 下 至 在 开发 过 程 中 引入 的 库 和 框架 。 


你 要 问 自己 的 问题 是 ， 你 的 架构 是 否 “ 管 用 ”。 对 我 来 说 ,一 个 染 构 如 果 能 满足 非 功能 性 需 
求 , 在 给 定 的 环境 约束 下 有 效 , 能 为 其 他 代码 提供 必要 的 基础 , 作为 平台 能 解决 潜在 的 业务 问题 ， 
那 就 是 管用 的 。 软 件 最 大 的 一 个 问题 就 是 , 它 复杂 而 抽象 ,很 难 通过 图 表 其 至 代码 本 身 可 视 化 一 
份 软件 在 运行 时 的 特征 。 此 外 ,我 并 不 总 是 相信 自己 第 一 次 就 能 做 好 。 当 然 了 ， 说 不 定 你 可 以 ! 


在 整个 软件 开发 的 生命 周期 中 , 为 了 有 信心 让 所 构建 的 系统 在 交付 时 能 正常 工作 , 我 们 会 进 
行 多 种 类 型 的 测试 。 那 为 什么 不 对 架构 也 这 样 做 ?如 果 能 测试 架构 ， 我 们 就 能 证 明 它 是 管用 的 。 
如 果 可 以 做 得 尽 可 能 简单 ， 我 们 就 能 降低 项 目 失败 的 整体 风险 。 架 构 师 应 该 像 优 秀 的 主 厨 一 样 ， 
品尝 自己 生产 的 东西 。 概 括 地 说 ,就 是 主动 发 现 、 减 轻 和 承担 高 优先 级 的 技术 风险 ,这 样 才能 保 
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住 你 的 项 目 和 工作 。 
4. 架构 演化 


很 多 时 候 , 软件 先 被 设计 好 , 然后 交 给 开发 团队 , 实际 上 在 把 软件 开发 当 作 接 力 运动 来 处 理 。 
结果 适得其反 ,因为 这 样 的 软件 架构 需要 照顾 。 得 有 人 看 着 它 , 在 整个 交付 过 程 中 依据 不 断 变化 
的 需求 和 团队 反馈 来 对 其 演化 。 如 果 架 构 师 创建 了 一 个 架构 , 为 什么 在 整个 交付 过 程 的 其 他 时 候 
不 自己 拥有 和 演化 这 个 架构 ? 这 关乎 持续 的 技术 领导 , 而 不 是 仅仅 参与 生命 周期 的 开始 阶段 , 然 
后 泰然 处 之 、 袖 手 旁 观 。 


5. 编写 代码 


我 认识 的 大 多 数 最 优秀 的 软件 架构 师 , 都 有 软件 开发 的 背景 , 但 由 于 种 种 原因 ,许多 组 织 } 
不 认为 写 代 码 是 软件 架构 角色 的 一 部 分 。 做 一 个 “实践 派 软 件 架 构 师 ”并 不 一 定 指 涉足 日 常 的 编 
码 任务 , 但 确实 意味 着 你 要 持续 地 参与 到 交付 中 ,积极 地 帮助 引导 和 塑造 它 。 说 了 这 么 多 , 为 什 
么 日 常 编码 工作 不 应 该 是 软件 架构 角色 的 一 部 分 ? 


许多 软件 架构 师 都 是 构建 大 师 ， 所 以 经 常 练 手 是 有 意义 的 。 此 外 ,编码 为 架构 师 提供 了 一 种 
与 团队 分 享 软件 开发 经 验 的 方式 , 从 而 帮助 他 们 更 好 地 理解 如 何 从 开发 的 角度 看 待 架构 。 许多 公 
司 都 有 阻止 软件 架构 师 参与 编码 工作 的 政策 ， 因 为 他 们 的 架构 师 “ 太 宝贵 了 , 不 该 承担 日 常 编码 
工作 ”。 这 显然 是 错误 的 ， 如 果 你 不 打算 让 软件 架构 师 为 成 功 交付 做 出 自己 的 贡献 ， 为 什么 还 要 
让 他 们 为 软件 设计 投入 全 部 精力 ? 


当然 , 有 些 情况 下 要 参与 到 代码 级 别 并 不 实际 。 例 如, 一 个 大 型 项 目 通常 意味 着 要 照看 更 大 
的 “大 局 *"， 有 可 能 你 根本 没 时 间 写 代码 。 但 是 一 般 来 说 ,一 个 写 代 码 的 软件 架构 师 会 更 有 成 效 
也 更 快乐 。 你 不 应 该 因为 “我 是 架构 师 ”， 就 把 自己 排除 在 编码 之 外 。 


6. 质量 保证 


即使 有 了 址 界 上 最 好 的 架构 , 糟糕 的 交付 也 能 让 原本 可 以 成 功 的 软件 项 目 失 败 。 质量 保证 应 
该 是 软件 架构 角色 的 一 部 分 , 但 它 的 内 容 不 只 是 代码 评审 。 你 要 保证 一 条 基线 , 它 可 以 是 引入 一 
些 标准 和 工作 实践 , 如 编码 标准 、 设计 原则 和 工具 。 质量 保证 也 包括 确保 团队 对 架构 实现 的 一 致 。 
管 它 叫 架构 服从 还 是 架构 一 致 取决 于 你 ,但 都 要 遵循 技术 愿景 。 

可 以 肯定 地 说 ,大 多 数 项 目 没 有 做 足够 的 质量 保证 ,因此 ,你 要 和 弄 清楚 什么 是 重要 的 ， 并 确 
保 它 有 充分 的 保证 。 对 我 来 说 ， 只 要 是 架构 上 显著 的 、 业 务 上 关键 的 、 复 杂 的 和 高 度 可 见 的 ， 都 
是 一 个 项 目的 重要 组 成 部 分 。 你 要 务实 地 认识 到 没 办 法 保证 每 件 事 。 
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合作 或 失败 


一 个 软件 系统 很 少 孤 立 存在 ,可 能 有 不 少 人 要 为 整个 架构 过 程 作 贡献 。 这 包括 了 从 需要 理解 
和 认同 架构 的 直接 开发 团队 , 一 直到 那些 对 安全 性 、 数 据 库 、 和 运营、 维护 或 支持 感 兴趣 的 人 组 成 
的 扩展 团队 。 任何 担任 软件 架构 角色 的 人 都 需要 与 这 些 人 合作 ,以 确保 架构 能 与 周围 环境 成 功 整 
合 。 如 果 不 合作 ， 就 等 着 失败 吧 。 


技术 领导 是 一 个 角色 而 非 级 别 


软件 架构 的 角色 基本 上 就 是 向 软件 团队 引入 技术 领导 ， 有 必要 重申 的 是 ， 我 这 里 谈论 的 是 
一 个 角色 ， 而 非 职务 级 别 。 通 常 ， 大 型 组 织 会 作为 对 长 期 服务 的 奖励 ， 或 者 因为 想 给 菜 人 加 薪 ， 
而 搬出 “架构 师 ” 的 头衔 。 如 果 接 受 这 个 头衔 的 人 具备 承担 这 个 角色 的 能 力 ， 那 就 没 问 题 ， 但 
情况 并 不 总 是 如 此 。 如 果 你 订阅 过 LinkedIn 或 Stack Overflow 的 软件 架构 讨论 组 ， 可 能 见 过 类 
似 的 问题 : 


嘿 ， 我 刚 普 升 为 软件 架构 师 ， 但 我 不 知道 该 干 些 什 么 。 救 救 我 ! 我 要 看 什么 书 ? 


尽管 无 法 阻挡 一 些 组 织 让 人 晋升 到 超出 其 能 力 的 角色 , 我 还 是 可 以 描述 自己 对 软件 架构 角色 
的 看 法 。 设 计 软 件 可 能 是 这 个 角色 乐趣 的 一 部 分 ， 但 一 个 成 功 的 软件 项 目 远 不 止 如 此 。 


提出 你 自己 对 这 个 角色 的 定义 
尽 


根据 我 的 经 验 , 尽管 很 多 软件 团队 都 明白 自己 需要 软件 架构 这 个 角色 , 却 往往 没有 一 个 参考 
定义 。 少 了 这 个 定义 ， 很 可 能 就 无 法 履行 这 个 角色 的 部 分 或 全 部 职责 。 

大 多 数 跟 软 件 开发 团队 有 关 的 角色 都 比较 容易 理解 一 开发 人 员 、 测 试 人 员 、 流 程 经 理 、 产 
品 所 有 者 、 业 务 分 析 师 、 项 目 经 理 ， 等 等 。 软 件 架构 角色 ?不 清楚 。 我 经 常 问 软件 团队 对 软件 架 
构 角色 有 没有 参考 定义 ， 常 见 的 回答 不 外 乎 “没有 ”或 “有 ， 但 我 们 不 用 ”"。 同 一 个 团队 的 人 往 
往 会 给 出 不 同 答案 。 


软件 架构 的 必要 性 通常 是 公认 的 , 但 这 个 角色 的 责任 往往 并 不 明确 。 根 据 我 的 经 验 , 这 可 能 
导致 没有 人 承担 这 个 角色 , 或 者 有 人 被 安排 了 这 个 角色 ， 却 不 真正 了 解 应 该 怎么 做 。 如 果 没 有 理 
解 角色 ， 就 不 会 发 挥 相应 的 作用 ， 更 亿 论 培养 未 来 的 软件 架构 师 。 


不 管 你 怎么 称呼 它 〈 比如 架构 师 、 技 术 主 管 、 首 席 设计 师 等 )， 我 的 建议 都 很 简单 。 如 果 你 
没有 什么 东西 可 以 用 来 表达 “这 就 是 我 们 对 软件 架构 师 的 期 望 ”， 花 些 时 间 想 想 这 回 事 。 首 先 ， 
对 于 对 软件 架构 角色 的 期 望 ， 要 跟 你 的 团队 达成 共识 ; 然后 ， 如 果 看 到 益处 ， 就 在 你 的 组 织 里 对 
其 标准 化 。 
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软件 架 怡 师 应 诅 编 反 蚂 


既然 我 创建 了 一 个 叫 作 编码 架构 的 网 站 ,我 猜 这 个 问题 的 答案 就 不 出 人 意料 了 。 在 我 理想 


的 世界 观 中 ,软件 架构 师 应 该 编码 。 曾 经 有 人 告诉 我 ,优秀 架构 师 的 重要 特征 是 抽象 思维 能 


也 可 以 理解 成 不 把 所 有 时 间 都 耗 在 细节 里 的 能 力 。 这 没 错 , 但 你 画 的 那些 框框 线 线 终归 要 形成 


代码 。 


编写 代码 


我 的 建议 是 让 编码 成 为 你 作为 软件 架构 师 角 色 的 一 部 分 , 只 要 把 自己 当 作 软件 开发 团队 的 一 
份子 就 行 了 。 换 句 话 说 , 你 有 一 项 软件 架构 的 帽子 和 一 顶 编写 代码 的 帽子 。 你 不 见得 要 成 为 团队 


里 写 代码 最 厉害 的 ， 但 参与 到 实践 和 交付 流程 的 好 处 非常 大 。 毕 竟 ,“ 知 ”和 “ 行 ” 还 是 不 同 的 


O 


团队 欣 闻 你 要 贡献 代码 ,通常 会 受到 辟 励 ， 确 保 你 的 设计 能 落 到 实处 。 如 果 没 有 , 那么 一 旦 


你 站 在 开发 者 的 角度 明白 了 这 个 问题 ， 很 快 就 能 体会 到 那 种 痛苦 。 


创建 能 实际 实现 的 软件 架构 ,这 样 做 的 好 处 显而易见 ， 除 此 之 外 ,贡献 代码 还 能 帮助 你 和 团 


队 建 立 起 融洽 的 关系 ， 有 助 于 缩短 存在 于 很 多 软件 团队 的 架构 师 和 开发 者 之 间 的 距离 。 引 用 瑞 


秋 “ 戴 维 斯 (Rachel Davies ) 和 丽 效 ' 赛 德 利 (Liz Sedley ) 在 《敏捷 教练 如 何 打造 优秀 的 敏 提 
团队 》 一 书 中 说 的 话 : 


GD http:/www.codingthearchitecture.com 
© http://pragprog.com/book/sdcoach/agile-coaching 
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如 果 你 了 解 如 何 编程 ， 往 往 会 忍 不 住 对 开发 者 该 如 何 编写 代码 提出 建议 。 小 心 ， 因 
为 你 可 能 在 浪费 时 间 : 如 果 你 没有 参与 项 目的 编程 ， 开 发 者 多 半 会 无 视 你 的 编码 经 验 。 
他 们 还 会 认为 你 越权 ， 影 响 了 他 们 的 工作 ， 所 以 尽量 别 在 这 方面 指 指点 点 。 


构建 原型 、 框 架 和 基础 


当 你 被 看 作 开发 团队 的 一 员 时 ， 软 件 架构 的 角色 可 能 会 轻松 得 多 ， 然 而 有 了 时 这 却 不 太 可 能 。 
晋升 或 被 指定 为 软件 架构 师 带 来 的 一 个 问题 在 于 , 你 可 能 会 发 现 自己 不 能 像 期 望 的 那样 写 很 多 代 
码 。 这 可 能 因为 时 间 压 力 , 因为 你 有 很 多 “架构 ”工作 要 做 , 或 者 只 是 公司 政策 不 允许 你 写 代 码 ， 
我 见 过 这 样 的 情况 。 如 果 是 这 样 的 话 , 对 软件 系统 中 有 疑问 的 概念 构建 原型 和 证 明 是 一 个 很 好 的 
参与 方式 。 这 让 你 可 以 和 团队 建立 起 融洽 的 关系 ， 也 是 评估 你 的 架构 是 否 管用 的 好 办 法 。 

作为 蔡 代 , 你 可 以 帮助 建立 团队 可 用 的 框架 和 基础 。 试 着 抵挡 住 构建 好 这 些 东西 再 交 给 团队 
的 诱惑 ， 因 为 这 样 可 能 会 适得其反 。 软 件 开发 非常 容易 赶 潮流 ， 所 以 小 心 别 构建 出 一 个 东西 却 被 
团队 当 作 毫 无 价值 的 过 时 破烂 ! 


进行 代码 评审 

显然 没有 什么 能 代替 给 真正 的 项 目 编码 , 我 也 不 推荐 把 代码 评审 作为 一 个 长 期 的 战略 , 但 参 
与 (或 做 ) 代码 评审 至 少 能 让 你 了 解 新 技术 及 其 应 用 。 对 于 你 没有 经 验 的 技术 ,挑剔 或 参与 讨论 
可 能 会 损害 你 的 名 声 。 我 记得 自己 曾 不 得 不 向 一 个 从 未 写 过 一 行 Java 代码 的 架构 师 解 释 自己 的 
Java 代码 。 那 很 无 聊 。 


实验 并 与 时 俱 进 


你 需要 保持 一 定 水 平 的 技术 知识 , 才能 称职 地 用 它 来 进行 方案 设计 。 但是， 如果 无 法 对 交付 
做 出 贡献 ， 作 为 架构 师 的 你 要 如 何 维持 编码 技能 ? 


在 工作 之 外 你 往往 有 更 多 的 空间 来 维持 编码 技能 ， 从 贡献 开源 项 目 , 到 不 断 尝试 你 感 兴趣 的 
最 新 语言 、 框 架 、API。 书 、 博 客 、 播 客 、 会 议和 至 会 都 能 达到 这 个 目的 。 但 有 时 候 你 必须 跳出 
代码 。 这 些 事 我 当然 都 做 过 , 乘坐 公共 交通 工具 长 途 通 勤 的 一 个 好 处 是 你 有 时 间 去 玩 技 术 。 当 然 
了 ， 前 提 是 你 经 过 一 天 的 辛勤 工作 还 不 犯困 的 话 ! 


软件 架构 师 和 雇主 之 间 的 矛盾 


我 很 幸运 ,我 的 软件 架构 角色 中 有 相当 部 分 的 实践 元 素 , 大 多 数 我 参与 的 项 目 都 有 我 的 代码 。 
我 坚定 地 认为 ,机 会 是 自己 创造 的 。 我 仍然 动手 实践 的 原因 可 以 这 样 表述 : 它 是 这 个 角色 的 重要 
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组 成 部 分 。 对 我 来 说 这 很 简单 。 设 计 软 件 时 ， 编 码 是 必 不 可 少 的 ， 因 为 我 需要 熟悉 最 新 的 技术 ， 
搞 清楚 我 设计 的 哪些 东西 能 工作 。 男 外 ， 我 得 承认 编码 很 有 趣 。 


可 异 , 许多 组 织 似乎 认为 编码 是 软件 开发 过 程 中 最 容易 的 部 分 , 因此 他 们 通常 让 男 一 个 国家 
的 其 他 人 来 做 这 件 事 ， 以 为 这 样 能 省 钱 。 好 的 代码 在 这 样 的 组 织 看 来 也 是 “ 低 价 值 ”的 。 组 织 
软件 架构 师 的 资历 和 编码 工作 的 价值 就 脱节 了 ， 了 矛盾 由 此 产生 。 


以 我 的 经 验 ， 小 组 织 不 会 发 生 这 种 事 ， 因 为 需要 人 手 时 每 个 人 都 要 参与 进来 。 是 的 ,那些 大 
型 组 织 里 的 矛盾 最 严重 。 我 曾 在 一 个 中 等 规模 的 咨询 公司 工作 过 一 段 时 间 , 我 的 职位 等 级 把 我 归 
入 管理 团队 ,但 我 仍 会 写 代码 。 在 某 些 方面 ， 顶 着 “行政 经 理 ” 的 头衔 ， 又 能 每 天 写 代码 ， 真 是 
了 不 起 的 成 绩 ! 但 有 时 这 也 让 人 很 不 舒服 , 因为 其 他 经 理 经 常会 试图 在 其 组 织 架 构图 里 加 上 我 的 
名 字 。 

陷入 这 种 情况 是 很 麻烦 的 ， 只 有 你 自己 能 摆脱 它 。 无 论 你 是 在 一 个 正在 发 生 这 种 事 的 组 织 ， 
还 是 想 要 离开 是 非 之 地 ,都 要 搞 清 楚 你 对 软件 架构 师 这 个 角色 的 看 法 ,并 准备 好 坚守 自己 的 立场 。 


你 不 必 放 弃 编码 


说 到 这 一 点 ,我 会 经 常 被 问 及 “如 果 软 件 架 构 师 打算 在 公司 的 职业 道路 上 有 所 作为 ,是 否 还 
能 继续 编码 ”， 也 就 不 奇怪 了 。 这 真是 羞耻 ， 尤 其 是 如 果 这 些 人 真 的 很 喜欢 他 们 所 做 的 技术 。 


对 此 我 的 态度 绝对 是 肯定 的 , 你 可 以 继续 写 代 码 。 对 我 来 说 ， 听 到 人 们 说 “好 吧 , 为 了 成 为 
架构 师 或 在 职业 道路 上 更 进一步 ， 我 明白 自己 不 得 不 放弃 编码 了 ”， 是 相当 令 人 泪 丧 的 。 有 很 多 
组 织 是 这 样 的 ， 肯 定 有 很 多 人 被 告知 组 织 中 的 高 级 职位 不 需要 写 代 码 。 

软件 架构 师 在 满足 非 功 能 性 需求 、 进 行 技 术 质 量 保证 、 确 保 软 件 符合 其 用 途 等 方面 , 要 承担 
很 大 的 责任 。 这 是 一 个 领导 的 角色 ， 编 码 ( 以身作则 ) 是 保证 项 目 成 功 最 好 的 方式 之 一 。 此 外 ， 
如 果 软 件 架 构 师 不 保持 技术 能 力 ， 谁 来 培养 更 多 未 来 的 软件 架构 师 ? 


不 要 把 全 部 时 间 都 用 于 编码 


重申 一 下 我 的 建议 , 软件 架构 师 不 必 放 弃 编 码 。 无 论 你 怎么 做 ,在 不 断 变化 的 世界 中 ,编码 
是 一 个 保持 技术 能 力 的 好 办 法 。 很 多 人 认为 软件 架构 是 一 种 “后 技术 ”的 职业 选择 , 但 除了 丰富 
的 经 验 和 更 宽 的 知识 面 ， 它 还 需 座 厚 的 技术 能 力 ， 需 要 能 够 回答 设计 是 否 真 的 管用 这 类 问题 的 工 
形 人 才 。 把 这 归 为 “实现 细节 ”是 不 可 接受 的 。 只 是 别 把 时 间 都 花 在 编码 上 。 如 果 你 花 全 部 时 间 
写 代 码 ， 那 软件 架构 角色 的 其 他 部 分 由 谁 来 扮演 ? 
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把 建筑 的 隐喻 应 用 到 软件 不 见得 合适 , 尽管 在 中 世纪 , 设计 建筑 的 人 只 是 极 少数 , 却 组 成 了 
建造 大 师 的 高 端 社团 。 之 所 以 做 这 样 的 隐喻 ， 是 因为 建造 大 师 名 副 其 实 是 他 们 这 门 学 问 的 大 师 ， 
一 旦 达到 了 这 种 高 度 , 建造 大 师 是 继续 建造 还 是 让 其 他 名 气 不 大 的 人 来 做 ? 几 百 年 后 , 我 们 似乎 
又 在 对 软件 行业 问 同样 的 问题 。 


联盟 的 状态 


在 过 去 的 十 年 间 ， 由 于 “大 型 预先 设计 ”和 “分 析 麻 痹 ”等 问题 ， 软 件 架构 已 经 失宠 。 这 多 
半 源 于 为 了 更 有 效 地 交付 软件 系统 , 敏捷 方法 作为 主要 的 催化 剂 , 减少 了 很 多 团队 都 要 做 的 预先 
思考 的 工作 量 , 结果 现在 “架构 师 ” 在 软件 团队 里 往往 被 看 作 是 多 余 的 。 很 多 团队 都 向 着 扁平 化 
和 自 组 织 努 力 ， 从 表面 上 看 这 不 需要 再 专 设 技术 领导 。 

男 一 个 因素 是 , 许多 人 认为 架构 师 都 在 做 高 层次 的 抽象 思维 。 我 相信 你 已 经 见 过 “象牙 塔 架 
构 师 ”或 “PPT 架构 师 ” 等 说 法 ， 用 来 指 代 那些 设计 解决 方案 时 从 不 考虑 细节 的 人 。 如 果 我 们 回 
顾 一 下 过 去 ， 这 可 不 是 架构 师 的 角色 。 


回顾 过 去 


如 果 你 追溯 “架构 师 ”( architect ) 一 词 在 拉丁 语 (architectus ) 和 希腊 语 ( arkhitekton ) 的 源 
头 , 直译 就 是 “首席 建筑 师 ”， 从 字面 上 看 , 这 些 人 是 他 们 这 行 中 的 佼佼 者 。 在 中 世纪 ,“ 建 筑 师 ” 
一 词 指 “石匠 大 师 ”, 因为 石头 是 当时 的 主要 建筑 材料 。 下面 这 句 话 对 这 个 角色 做 了 很 好 的 总 结 ?: 
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石匠 大 师 ， 就 是 石头 的 操作 者 、 艺 术 家 和 设计 师 。 
这 人 句 话 同样 适用 于 我 们 软件 开发 者 。 


造 大 师 真 的 会 建造 吗 
关键 问题 是 ,建造 大 师 是 否 真 的 建造 了 什么 ? 如 果 你 研究 一 下 人 们 如 何 实现 “石匠 大 师 ” 的 
角色 ， 就 会 发 现 一 些 类 似 的 东西 ": 


尽管 石匠 大 师 受 人 尊敬 、 通 常 也 很 富有 ， 然 而 在 达到 行业 顶峰 之 前 ， 他 必须 经 历 石 
折 、 监 督 的 历练 来 证 明 自 己 的 价值 。 


架构 师 的 维基 百科 页 面 说 了 相同 的 话 ”: 


在 古代 和 中 世纪 的 历史 中 , 大 多 数 建筑 设计 和 建设 都 是 工匠 完成 的 : 下 至 石匠 和 木 
上 至 建造 大 师 。 


有 趣 的 是 ， 对 于 这 些 石匠 大 师 参与 过 多 少 建筑 ， 并 没有 一 个 统一 观点 。 比 如 


他 实际 上 做 了 多 少 ， 其 实 是 有 争议 的 。 这 个 术语 可 能 会 有 所 不 同 ， 但 是 ， 以 我 的 理 
解 ， 中 世纪 石匠 大 师 基本 的 组 织 和 角色 跟 今天 的 首席 建筑 师 是 类 似 的 : 这 也 许 反映 了 建 
筑 建造 不 变 的 基本 。 
真正 有 意义 的 是 看 看 这 个 角色 承担 了 什么 。 引 用 男 一 段 话 ”: 


顶尖 的 石匠 就 是 一 个 石匠 大 师 。 然 而 ， 建筑 大 师 这 个 头衔 ， 指 的 是 全 面 负责 建筑 工 
地 、 让 石匠 大 师 们 为 他 工作 的 那个 人 。 建 筑 大 师 也 负责 木匠 、 玻 璃 工匠 等 。 实 际 上 ,每 
个 建筑 工地 上 的 人 都 在 建筑 大 师 的 监督 下 工作 。 


再 加 一 些 额外 的 细节 ”: 


然后 , 石匠 大 师 为 将 要 建造 的 东西 设计 结构 、 美 学 和 象征 等 方面 的 特性 , 组 织 后 勤 ， 
还 要 评定 工作 的 优先 级 并 决定 它们 的 顺序 。 
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象牙 塔 
如 果 这 听 起 来 很 熟悉 ， 等 一 等 ， 看 看 团队 过 去 是 如 何 工作 的 ”， 


每 一 个 小 石匠 都 遵循 大 师 设 定 的 方向 和 对 主要 结构 或 美学 的 所 有 决定 , 解决 那些 问 
题 都 是 大 师 的 工作 。 


显然 , 容易 看 出 很 多 软件 团队 的 传统 运作 方式 与 此 相似 , 敏捷 软件 开发 团队 希望 采用 一 种 不 
同 的 方法 也 就 不 奇怪 了 。 很 多 现代 的 软件 开发 团队 试图 让 一 群 人 分 担 技术 领导 者 的 角色 ,而 不 是 
安排 一 个 远离 细节 的 专门 角色 。 当 然 , 很 多 架构 师 远 离 细节 的 主要 原因 之 一 是 他 们 没有 时 间 。 这 
通常 导致 架构 师 在 现实 的 团队 日 常 工作 中 被 移 除 , 慢 慢 变 得 脱离 实际 。 过 去 的 石匠 大 师 也 被 这 个 
问题 困扰 ”: 


看 起 来 同时 进行 多 个 任务 是 很 平常 的 事情 , 石匠 大 师 很 少 参 与 体力 工作 ( 即使 身体 
条 件 允 许 ) 也 就 不 足 为 奇 ，1261 年 ， 尼 十 拉 斯 . 德 . 比 亚 德 (Nicholas de Biard ) 在 布 
道中 斥责 “只 靠 言 语 就 做 判断 ”的 石 哲 大师 的 明显 懒惰 ， 给 出 了 这 一 假设 的 证 词 。 


下 面 这 段 话 来 自 瑞 秋 “' 戴 维 斯 和 丽 效 ' 赛 德 利 所 著 的 《敏捷 教练 : 如 何 打造 优秀 的 敏捷 团 
队 》” ， 突 出 了 这 种 现象 在 软件 行业 中 造成 的 一 个 常见 后 果 : 


如 果 你 了 解 如 何 编程 ,往往 会 忍 不 住 对 开发 者 该 如 何 编写 代码 提出 建议 。 小心 ， 因 
为 你 可 能 在 浪费 时 间 : 如 果 你 没有 参与 项 目的 编程 ， 开 发 者 多 半 会 无 视 你 的 编码 经 验 。 
他 们 还 会 认为 你 越权 ， 影 响 了 他 们 的 工作 ， 所 以 尽量 别 在 这 方面 指 指点 点 。 


为 了 掩盖 这 种 局 面 , 很 多 人 会 把 软件 架构 的 角色 看 作 其 组 织 内 的 一 个 高 级 职位 或 级 别 ,从 而 
加 剧 了 开发 者 和 架构 师 之 间 的 脱节 。 看 来 ， 石 折 大 师 也 有 相同 的 境遇 ”: 
为 了 避免 这 种 争斗 , 文艺 复兴 后 期 的 艺术 家 们 不 再 被 视 为 只 是 普通 的 工匠 ， 而 石匠 


大 师 似 乎 被 神话 ( 在 我 看 来 ) 为 贵族 后 毅 。 此 外 ， 由 于 对 所 掌握 知识 秘 而 不 宣 ， 他 们 制 
造 了 一 种 神秘 感 ， 让 自己 有 别 于 其 他 不 那么 “神秘 ”或 “高 尚 ” 的 职业 。 


出 


建造 大 师 角色 的 差异 


多 数 看 法 都 一 样 : 建造 大 师 并 没有 太 多 时 间 去 建造 ,尽管 他 们 具备 这 样 的 技能 。 回 到 软件 行 
业 , 软件 架构 师 应 该 写 代 码 吗 ? 我 直截了当 地 回答 :“ 理 论 上 , 是 的 。” 更 完整 的 答案 可 以 在 这 本 
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书 里 面 找 到 。 为 什么 ?因为 技术 不 是 一 个 实现 细节 ， 你 需要 理解 为 自己 的 决定 所 做 的 取舍 。 


那么 现代 建筑 师 为 什么 不 为 实际 的 建造 过 程 出 力 呢 ? 为 了 回答 这 个 问题 , 我 们 要 看 看 这 个 角 
色 这 些 年 是 如 何 演化 的 ”: 


在 二 代 和 中 世纪 的 历史 中 , 大 多 数 建筑 设计 和 建设 都 是 工匠 完成 的 : 下 至 石匠 和 木 
折 ， 上 至 建造 大 师 。 直 到 现代 ， 建 筑 师 和 工程 师 之 间 也 没有 明显 的 区 别 。 在 欧洲 ， 建 筑 
师 和 工程 师 的 头衔 主要 因 地 域 不 同 而 经 常 交 替 使 用 ， 但 指 的 都 是 同一 个 人 。 


结构 工程 的 维基 百科 页 面 "提供 了 更 多 信息 : 


自从 人 类 开始 修筑 属于 自己 的 结构 ， 结 构 工 程 就 出 现 了 。 在 19 世纪 未 的 工业 革命 
期 间 ， 建 筑 专 业 体 现 出 了 与 工程 专业 的 不 同 ， 成 为 一 个 更 正式 的 专业 。 直 到 那 时 ， 建 筑 
师 和 结构 工程 师 通常 还 是 同一 个 人 : 建造 大 师 。19 世纪 和 20 世纪 初 ， 随 着 结构 理论 专 
业 知 识 的 发 展 ， 专 门 的 结构 工程 师 才 开始 出 现 。 


本 质 上 ， 传 统 建 筑 师 的 角色 已 经 分 化 为 两 种 。 一 种 是 结构 工程 师 ， 确 保 建 筑 物 不 倒塌 ; 另 
一 种 是 建筑 师 ， 负 责 与 客户 交流 ， 收 集 他 们 的 需求 ， 从 美学 的 视角 进行 建筑 设计 。 马 丁 : 福 勒 
(Martin Fowler ) 的 blikiV 有 一 个 页 面谈 到 了 两 种 角色 差异 的 意义 : 


软件 架构 师 被 看 作 是 首席 设计 师 ， 是 把 项 目的 每 件 事 凝聚 在 一 起 的 人 。 但 建筑 师 可 
不 会 干 这 些 。 建 筑 师 关注 的 是 与 想 要 建筑 的 客户 交流 。 他 的 精力 集中 在 客户 觉得 重要 的 
事情 上 ， 比 如 建筑 的 布局 和 外 观 。 但 建筑 也 不 仅 限 于 此 。 


因 其 背后 蕴含 的 包括 物理 定律 在 内 的 丰富 知识 , 建筑 现在 被 看 作 是 一 门 工 程 学 科 , 这 些 知 识 
能 够 建 模 和 预测 建材 的 行为 。 相 比 之 下 ,软件 开发 行业 还 比较 年 轻 , 正 以 惊人 的 速度 发 展 。 今天 
的 建筑 大 多 还 是 使 用 和 几 百 年 前 相同 的 材料 ， 但 似乎 我 们 每 20 分 钟 就 会 发 明 一 种 新 技术 。 我 们 
生活 在 “互联 网 时 代 ”。 除 非 我 们 这 个 行业 发 展 到 软件 的 构建 方式 和 预测 工程 项 目 相同 ， 和 否则 团 
队 中 有 人 一 直 跟随 技术 的 发 展 , 有 能 力 做 出 如 何 设计 软件 的 正确 决策 , 还 是 很 重要 的 。 换 句 话说 ， 
软件 架构 师 还 需要 扮演 结构 工程 师 和 建筑 师 的 角色 。 


实现 角色 


最 后 , 简要 地 说 一 下 ， 人 们 如 何 实 现 石 匠 大 师 的 角色 。 下 面 这 段 话 来 自 维基 百科 的 “石匠 工 
艺 ” 页 面 *: 
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中 世纪 对 石匠 技能 的 需求 很 大 ， 行 业 协 会 的 成 员 按 水 平 被 划分 为 三 个 等 级 : 学 徒 、 帮 
工 和 石 哲 大师。 学 秆 要 和 师傅 签订 契约 ， 以 此 换取 师傅 的 培训 ; 帮工 的 技能 要 高 一 些 ， 可 
以 到 外 面 去 协助 别 的 师傅 ; 石匠 大 师 被 看 作 自 由 人 ， 可 以 按 自己 的 意愿 选择 主 顾 的 项 目 。 


这 反映 了 我 自己 担任 软件 架构 角色 的 经 验 。 它 是 一 个 渐进 的 过 程 。 像 很 多 人 一 样 , 我 的 职 ， 
生涯 始 于 在 别人 的 监督 下 写 代 码 ， 渐 渐 地 ， 当 我 获得 更 多 的 经 验 ， 就 开始 承担 更 大 的 设计 任务 。 
不 同 于 中 世纪 的 建筑 行业 , 对 于 如 何 从 初级 开发 者 到 软件 架构 师 , 软件 开发 行业 缺乏 明确 的 路 线 。 
我 们 没有 普遍 的 学 徙 模式 。 


架构 师 要 和 团队 一 起 工作 


对 很 多 组 织 来 说 ,这 里 有 个 大 问题 : 找 不 到 足够 的 架构 师 。 虽然 石匠 大 师 可 能 没有 太 多 时 间 
自己 去 跟 石头 打交道 ,但 还 是 和 团队 一 起 工作 。 我 常常 遇 到 一 些 架 构 师 ,他 们 要 协助 多 个 不 同 团 
队 。 很 明显 ， 如 果 和 多 个 不 同 团队 一 起 工作 ， 要 向 软件 交付 的 实践 部 分 做 出 贡献 是 不 现实 的 ， 你 
没有 时 间 写 任何 代码 。 


在 多 个 团队 中 扮演 软件 架构 角色 ， 并 不 是 一 个 有 效 的 工作 方式 。 通常 这 种 情况 发 生 时 ,都 有 
一 个 由 被 视 为 共享 资源 的 架构 师 组 成 的 中 心 组 ( 比如 “企业 架构 组 ” )。 根 据 我 所 读 到 的 ， 石 车 大 
师 任何 时 候 都 会 只 关注 一 个 建筑 工地 , 这 也 正 是 我 们 的 软件 开发 团队 应 该 采用 的 方法 。 如 果 你 认 
为 这 不 可 能 ， 就 看 看 中 世纪 建筑 行业 是 怎么 解决 这 个 问题 的 ”: 


每 个 石匠 都 会 带 一 个 为 他 工作 的 学 徒 。 当 石匠 接 下 一 份 新 工作 ， 学 徒 也 会 跟着 他 。 
如 果 石 匠 觉 得 自己 的 学 徒 已 经 对 行当 足够 了 解 ， 就 会 让 他 在 石匠 行 会 接受 考验 。 
再 次 回 到 了 典型 的 学 徒 模 式 ， 这 也 是 为 什么 指导 和 辅导 应 该 是 现代 软件 架构 角色 的 一 部 分 。 
我 们 需要 培养 未 来 的 软件 架构 师 ， 每 个 软件 开发 团队 都 需要 他 们 自己 的 建造 大 师 。 


GD http://www.historylearningsite.co.uk/medieval_ masons.htm 
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软件 开发 和 架构 之 间 的 界线 很 诡异 。 有 些 人 会 告诉 你 这 个 界线 并 不 存在 , 架构 就 是 由 开发 者 
负责 的 设计 流程 的 延伸 。 另 一 些 人 则 说 这 是 一 个 巨大 的 深渊 ， 只 有 志向 远大 的 开发 者 才能 跨 过 ， 
他 们 坚信 必须 尽 可 能 地 抽象 ， 而 不 拘泥 于 讨厌 的 实现 细节 。 跟 往常 一 样 ， 这 中 间 有 一 种 务实 的 平 
衡 ， 但 它 也 带 来 了 一 个 有 趣 的 问题 : 你 如 何在 两 者 之 间 穿 梭 ? 

一 些 常 被 用 于 区 分 软件 架构 和 软件 设计 的 关键 因素 包括 规模 的 扩大 、 抽 象 层 级 的 增加 、 做 
出 正确 设计 决策 的 意义 等 。 软 件 架 构 就 是 总 览 全 貌 ， 看 清 “ 大 局 ”"， 才 能 理解 软件 系统 整体 如 何 
工作 。 


这 可 能 有 助 于 区 分 软件 设计 和 架构 , 然而 不 一 定 有 助 于 理解 软件 开发 者 如 何 转换 到 软件 架构 
的 角色 。 此 外 ， 对 于 辨别 谁 会 成 为 一 个 好 的 软件 架构 师 ， 以 及 要 如 何 招聘 到 他 们 ， 也 没有 帮助 。 


经 验 是 一 个 好 的 评价 标准 ， 但 你 需要 看 得 更 深 


你 需要 从 软件 架构 师 身 上 寻找 许多 不 同 的 品质 , 他 们 过 去 的 经 验 往往 能 很 好 地 评判 他 们 承担 
这 个 角色 的 能 力 。 既 然 软 件 架 构 师 是 一 个 变化 的 角色 ,你 就 要 看 得 更 深 ,才能 理解 参与 度 、 影 响 
力 、 领 导 力 和 责任 感 的 水 平 , 这 些 在 多 个 不 同 领域 都 已 经 论证 过 。 结合 我 对 软件 架构 角色 的 定义 ， 
每 个 部 分 都 能 够 且 应 该 单独 评估 。 毕竟 , 软件 设计 过 程 看 起 来 相当 简单 , 要 做 的 就 是 搞 清 楚 需 求 ， 
设计 一 个 能 满足 它们 的 系统 。 但 在 现实 中 可 不 是 这 么 简单 ， 人 们 承担 的 软件 架构 角色 可 能 千 差 万 
别 。 比 如 下 面 这 些 。 


(1) 架构 驱动 力 : 捕捉 和 挑战 一 套 复杂 的 非 功 能 需求 ， 还 是 简单 地 假设 它们 的 存在 。 
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(2) 设计 软件 : 从 零 开 始 设计 一 个 软件 系统 ， 还 是 扩展 已 有 的 。 

(3) 技术 风险 : 证 明 你 的 架构 能 够 工作 ， 还 是 盲目 乐观 。 

(4) 架构 演化 : 持续 参与 和 演化 你 的 架构 ， 还 是 把 它 交 给 “实现 团队 ”。 
(5) 编写 代码 : 参与 交付 的 实践 部 分 ， 还 是 袖手旁观 。 

(6) 质量 保证 : 保证 质量 并 选择 标准 ， 还 是 反 其 道 而 行 之 或 无 所 作为 。 


其 中 大 部 分 可 以 归结 为 是 承担 寻找 方案 的 责任 还 是 推 话 问题 。 


模糊 的 宕 线 


不 管 你 认为 软件 开发 与 架构 之 间 的 界线 是 捉摸 不 透 还 是 深渊 , 人 们 对 于 软件 架构 角色 的 经 验 
水 平 各 不 相同 。 此 外 , 软件 开发 和 架构 之 间 的 界线 某 种 程度 上 是 模糊 的 。 大 多 数 开发 者 都 不 会 在 
某 个 星期 一 早上 醒 来 之 后 ， 突 然 宣称 自己 变 成 架构 师 了 。 我 肯定 不 是 的 ,我 通 入 软件 架 构 的 道路 
很 大 程度 上 也 是 一 个 演化 的 过 程 。 说 了 这 人 么 多 , 很 可 能 不 少 软件 开发 者 已 经 为 承担 部 分 软件 架构 
的 角色 做 好 了 准备 ， 不 论 他 们 的 头衔 是 什么 。 


跨越 弄 线 是 我 们 的 责任 
给 一 个 软件 系统 的 架构 出 力 和 为 之 负责 之 间 , 有 一 个 很 大 的 差异 , 那 就 是 构成 软件 架构 角色 


所 需 的 ， 路 越 不 同 领域 融会 贯通 的 技能 、 知 识 和 经 验 。 能 否 跨 越 软件 开发 者 和 架构 师 的 界线 ， 取 
决 于 我 们 自己 。 作 为 个 人 ， 我们 要 清楚 自己 的 经 验 水 平 ， 以 及 为 了 提升 它 我 们 需要 关注 什么 。 
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展 T 


二 注 


不 管 别人 怎么 说 ， 软 件 架 构 都 不 是 一 个 “后 技术 ”或 者 “ 非 技术 ”的 工种 。 在 白板 上 夯 一 堆 
框 、 线 和 云 ， 交 出 这 种 “软件 设计 ”， 可 不 是 软件 构架 师 所 为 。 


进一步 的 技术 能 力 


“T” 指 的 是 技术 , 这 也 正 是 优秀 的 软件 构架 师 应 该 懂得 的 。 作 为 软件 开发 者 , 我 们 倾向 于 去 
搞 懂 编 程 语言 语法 、API、 框 架 、 设 计 模 式 、 自 动 化 单元 测试 和 其 他 所 有 日 常 使 用 的 底层 技术 。 
对 一 个 软件 构架 师 来 说 , 这 些 也 是 基础 知识 。 为 什么 ?因为 扮演 软件 构架 角色 的 人 要 懂 技 术 ， 这 
样 他 们 至 少 能 如 实 回答 以 下 类 型 的 问题 。 


口 该 方案 是 否 有 效 ? 
口 我 们 要 这 样 去 构建 吗 ? 


然而 ， 从 熟练 掌握 不 同 编程 语言 的 学 习 曲 线 来 看 ， 软 件 专 业 人 员 人 常常 只 精 通 一 到 两 项 技术 。 
最 后 ， 这 些 人 都 会 被 叫 作 “Java 开发 者 “Oracle 开发 者 ”什么 的 。 我 本 人 曾 是 如 此 ， 也 在 很 多 
组 织 中 目睹 这 种 情况 。 如 果 你 还 对 编程 语言 的 宗教 战争 感到 困惑 ， 看 看 有 多 少 这 样 的 前 级 吧 。 


尽管 我 们 努力 保持 开放 的 思维 , 但 还 是 受 困 于 单一 的 技术 栈 。 其 实 这 也 没什么 错 , 但 你 不 得 
不 小 心地 保持 开放 思维 。 俗 话说 ,“ 如 果 你 只 有 一 把 锤子 , 一 切 看 起 来 都 像 钉 子 ”。 获 得 经 验 是 学 
习 之 旅 的 重要 组 成 部 分 , 但 不 要 被 经 验 束缚 。 比 如 说 , 并 不 是 每 个 软件 都 需要 一 个 关系 型 数据 库 ， 
但 在 团队 勾画 候选 的 软件 架构 时 ， 往 往 第 一 个 就 会 画 它 。 
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知识 面 宽 
这 让 我 想 谈 谈 为 什么 技术 知识 面 宽 对 软件 构架 师 来 说 也 很 重要 。 当 然 ， 他 们 可 能 是 Java 或 
者 Oracle 专家 ， 但 软件 构架 角色 的 要 求 更 高 。 例 如 ， 他 们 要 能 够 回答 以 下 类 型 的 问题 。 


口 和 其 他 可 选 技术 相 比 ， 我 们 所 选 的 是 否 最 合适 ? 
口 对 该 系统 的 设计 和 构建 ， 还 有 哪些 选择 ? 
口 是 否 应 该 采用 一 种 通用 的 架构 模式 ? 

口 我 们 是 否 明 白 所 做 决策 的 利 次 ? 

口 我 们 照顾 到 了 品质 属性 的 需求 吗 ? 

口 如 何 证 明 这 种 架构 行 之 有 效 ? 


软件 架构 师 是 通才 型 专家 


我 所 知 大 部 分 最 优秀 的 软件 设计 师 都 有 软件 开发 背景 。 这 并 不 意味 着 他 们 是 团队 中 最 好 的 程 
序 员 , 但 他 们 能 够 在 底层 细节 和 大 局 之 间 切 换 。 他 们 还 有 着 深厚 的 技术 积累 ， 以 及 从 多 年 软件 构 
建 的 经 验 中 获得 的 广阔 的 知识 面 。 但 他 们 不 能 ( 也 不 会 ) 总 是 知道 一 切 。 再 加 上 也 很 难 找到 一 个 
只 使 用 单一 技术 栈 的 软件 系统 。 我 在 职业 生涯 中 ， 见 过 一 些 采 用 混杂 技术 栈 的 系统 ， 包 括 : 


口 针对 多 个 Oracle 数据 库 的 微软 .NET 桌面 客户 端 ; 

口 通过 一 组 Java EE 网 络 服务 从 Oracle 数据 库 拉 取 数据 的 微软 ASPNET 网 站 ; 
口 从 Java 编写 的 REST 服务 拉 取 数据 的 10OS 和 Android 移动 应 用 ; 

口 用 微软 .NET 或 Ruby 编写 的 多 个 服务 构成 的 微服 务 架 构 ; 

口 从 微软 Dynamics CRM 系统 拉 取 数据 的 微软 ASPNET 网 站 ; 

口 通过 微软 .NET/Windows 通信 基础 服务 拉 取 数据 的 微软 SharePoint 网 站 ; 

口 与 SAP 集 成 的 Java EE 网 络 应 用 程序 ; 


虽然 一 般 性 的 设计 知识 、 技 巧 、 模 式 和 方法 通常 适用 于 许多 不 同 的 技术 , 但 不 明白 如 何 将 其 
成 功 应 用 在 底层 细节 上 可 能 会 导致 问题 。 这 是 否 意味 着 对 任何 特定 软件 系统 中 使 用 的 所 有 技术 ， 
软件 架构 师 都 应 该 是 专家 ? 不 ,合作 才 是 关键 。 找 到 那些 知 你 所 不 知 的 人 ,与 他 们 紧密 合作 。 没 
有 谁 说 软件 构架 的 角色 不 能 分 享 , 而 且 欣 然 认识 到 你 的 知识 差距 往往 是 创造 更 和 谐 的 工作 环境 的 
第 一 步 。 结 对 编程 有 好 人 处， 那么 为 什么 不 能 结对 架构 ? 


软件 染 构 是 技术 活 
支撑 软件 架构 角色 的 技术 知识 需要 深度 与 广度 并 存 的 知识 组 合 。 如 果 设计 软件 、 画 架构 图 的 


人 回答 不 了 该 架构 是 否 行 之 有 效 , 那 他 们 可 能 不 是 这 项 工作 的 正确 人 选 。 软 件 架 构 绝对 是 一 个 技 
术 工 种 ， 但 光 有 技术 还 不 够 ， 良 好 的 软 技 能 也 至 关 重 要 。 


第 1 .也 阐 
软 技 能 


本 书 主要 讨论 软件 架构 角色 跟 技 术 深 度 和 广度 有 关 的 部 分 。 但 这 只 是 一 部 分 , 我 们 本 质 上 谈 
论 的 是 领导 的 角色 ,“ 软 技能 ”或 “交际 能 力 ” 也 极其 重要 。 


口 领导 力 : 简单 来 说 ， 领 导 力 就 是 创造 共有 的 愿景 ， 并 带领 人 们 向 着 共同 目标 前 行 的 能 力 。 
口 沟通 : 你 有 世界 上 最 好 的 想法 和 愿景 ， 但 如 果 不 能 有 效 地 传达 给 其 他 人 ， 也 是 死路 一 条 。 
这 包括 了 软件 开发 团队 内 外 的 人 ， 要 使 用 适合 受众 的 语言 和 细节 水 平 。 

口 影响 力 : 这 是 重要 的 领导 技能 ， 从 毫 不 掩饰 的 劝说 到 神经 语言 编程 "或 绝地 控 心 术 ”， 它 
能 够 以 多 种 途径 实现 。 通 过 妥协 和 谈判 也 可 以 达到 这 样 的 目的 。 每 个 人 都 有 自己 的 想法 
和 计划 ， 你 在 处 理 时 还 得 让 他 们 都 不 反感 ， 并 主动 地 去 追求 你 需要 的 结果 。 好 的 影响 力 
也 要 求 好 的 倾听 和 探索 能 

口 信心 : 信心 很 重要 ， 是 有 效 的 领导 力 、 影 响 力 和 沟通 的 基础 。 但 信心 不 代表 傲慢 。 

口 合作 : 软件 架构 角色 不 应 该 被 孤立 ，( 与 其 他 人 ) 合作 想 出 更 好 的 方案 是 一 项 值得 实践 的 

技能 。 这 意味 着 倾听 、 谦 虚 和 响应 反馈 。 

口 指导 : 不 是 每 个 人 都 对 你 正 尝 试 做 的 事情 有 经 验 ， 你 需要 对 他 们 进行 角色 、 技 术 等 方面 

的 指导 。 

口 辅导 : 辅导 是 对 人 进行 学 习 方 面 的 指引 ， 而 非 告 诉 他 们 怎么 做 一 件 事 。 作 为 领导 ， 你 可 

能 会 被 要 求 去 辅导 团队 中 的 其 他 人 。 

口 动力 : 这 说 的 是 保持 团队 愉快 、 开 并 和 积极 。 团 队 要 有 积极 性 ， 才 会 跟随 你 这 个 软件 架 

构 师 所 创建 的 任何 愿景 。 你 还 要 面 对 团队 中 一 些 人 不 买账 的 局 面 。 


GD http://en.wikipedia.org/wiki/Neuro-linguistic_programming 
@ 电影 《星球 大 战 》 中 绝地 武士 ( Jedi Knights ) 的 技能 。 一 一 译 者 注 
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口 润滑 剂 : 你 经 党 需要 退 后 一 步 ， 促 进 讨 论 ， 特 别 是 团队 内 有 不 同意 见 时 。 这 需要 探索 、 

客观 ， 帮 助 团队 达成 共识 。 

口 政治 : 每 个 组 织 都 少不了 政治 。 我 的 响 语 是 ， 离 得 越 远 越 好 ,但 你 至 少 应 该 明白 周围 发 

生 了 什么 ,这样 才能 做 出 更 可 靠 的 决策 。 

口 责任 感 : 你 不 能 因为 失败 就 责备 软件 开发 团队 中 的 其 他 人 ， 有 责任 感 对 你 而 言 很 重要 。 
如 果 软 件 架 构 不 能 满足 业务 目标 ， 无 法 交付 非 功 能 性 需求 或 技术 品质 很 差 ， 那 都 是 你 的 
问题 。 

口 授权 : 授权 对 任何 领导 角色 来 说 都 是 一 个 重要 部 分 ， 作 壁 上 观 和 事 必 身 亲 之 间 有 一 条 模 

糊 的 界线 。 你 应 该 学 会 在 适当 的 时 候 授 权 ， 但 请 记 住 ， 你 授权 的 可 不 是 责任 。 


保持 积极 


不 管 你 怎么 看 ,软件 架构 师 都 是 一 个 领导 的 角色 ,对 开发 团队 中 不 少 人 来 说 ,作为 软件 架构 
师 的 你 都 可 能 会 是 重要 的 榜样 。 原因 是 什么 ? 团队 中 的 一 些 人 可 能 就 是 有 抱负 的 软件 架构 师 。 这 
种 处 境 让 人 肚 球 然 吧 ? 然而 如 果 你 把 视线 移 开 ， 还 是 能 看 到 一 些 负面 的 东西 。 


不 管 你 是 否 意识 到 了 , 你 都 在 一 个 非常 有 影响 力 的 位 置 上 , 你 的 一 举 一 动 都 被 整个 开发 团队 
看 在 腿 里 。 不 管 愿 不 愿意 ， 单 是 这 一 个 原因 ， 你 就 有 改变 整个 团队 的 能 量 。 如 果 你 很 主动 , 开发 
团队 也 很 可 能 变 得 主动 。 如 果 你 对 工作 充满 热情 , 团队 其 他 人 也 会 很 可 能 充满 热情 。 如 果 你 对 每 
件 事 都 很 乐观 ， 开 发 团队 也 会 这 样 。 

你 几乎 可 以 把 这 看 作 是 正 能 量 的 回路 , 你 的 热情 带动 了 团队 , 他们 的 热情 也 带动 你 。 这 无 比 
梦幻 , 但 也 不 难看 到 由 于 你 不 恰当 的 行为 而 造成 的 损害 。 任 何 程度 的 懒散 、 冷 漠 或 悲观 传染 到 团 
队 的 速度 ， 都 会 比 你 说 “但 我 们 会 没事 ”更 快 ， 然 后 你 就 会 陷入 消极 的 恶性 循环 。 

我 们 不 常 谈论 软件 架构 师 的 软 技 能 , 但 软 技能 有 时 候 比 过 硬 的 技术 更 重要 。 交付 产品 的 团队 
才 是 愉快 的 团队 。 作 为 领导 ， 让 团队 保持 积极 是 你 的 责任 ,你 的 角色 在 整个 团队 中 不 应 被 低估 。 
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更 敏捷 的 软件 团队 很 可 能 由 除了 一 项 核心 专长 , 还 具备 更 多 综合 知识 和 经 验 的 通才 组 成 。 理 
想 状况 下 , 这些 跨 领 域 的 团队 成 员 会 一 起 工作 , 运作 和 交付 一 个 软件 项 目 ， 承 担 从 收集 需求 和 架 


构 到 编码 和 部 署 的 所 有 事情 。 尽 管 很 多 软件 团队 都 朝 自 组 织 的 方向 努力 , 然而 现实 中 他 们 往往 更 
大 、 更 混乱 ， 而 且 由 专 才 构成 。 因 此 ， 这 些 团队 往往 需要 ， 也 确实 有 一 个 人 担任 技术 领导 。 
解决 方案 架构 师 


有 很 多 人 ， 特 别 是 在 大 型 组 织 里 ， 自 称 “ 解 决 方案 架构 师 ” 或 “技术 架构 师 ”。 他 们 设计 好 
了 软件 ， 为 自己 的 方案 编写 文档 ， 然 后 扔 给 一 个 单独 的 开发 团队 。 这 个 方案 一 旦 “完成 ”"， 架 构 
师 就 会 去 别 的 地 方 重复 这 个 过 程 ， 甚至 往往 对 开发 团队 的 进展 看 都 不 看 一 眼 。 如 果 再 加 上 “不 是 
我 发 明 的 ”综合 证 ， 结 果 往 往 就 是 接手 的 团队 不 会 对 这 个 方案 负责 ， 最 初创 建 的 “架构 ” 变 得 脱 
离 现实 。 

我 曾 见 过 不 少 这 样 的 架构 师 , 我 主持 过 的 一 次 面试 就 是 这 种 软件 开发 方法 的 缩影 。 在 照例 抛 
出 “ 谈 谈 你 的 角色 和 最 近 的 项 目 ” 这 个 问题 之 后 ， 我 就 清楚 地 知道 ， 面 前 这 个 〈 为 一 个 大 型 “ 蓝 
筹 ”咨询 公司 工作 的 ) 架构 师 的 所 作 所 为 ， 就 是 给 一 个 项 目 创建 软件 架构 ， 写 好 文档 然后 到 其 他 
地 方 重复 这 个 过 程 。 他 告诉 我 ， 给 出 “方案 ”后 就 很 少 或 不 再 参与 项 目 ， 然 后 我 问 他 怎么 知道 他 
的 软件 架构 是 管用 的 。 他 被 这 个 问题 困 住 了 ， 最 后 他 声明 这 是 “实现 细节 ”。 他 自信 地 认为 自己 
的 软件 架构 是 正确 的 ， 如 果 开 发 团队 没有 证 它 工 作 , 那 是 他 们 的 问题 。 在 我 看 来 ， 这 种 说 法 简直 
荒 瓷 ， 这 让 他 看 起 来 像 头 奏 驴 。 他 的 方法 也 就 是 AaaS…… “架构 即 服务 ””! 


QAaaS， 即 Architecture as a Service。 一 一 译 者 注 
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要 有 人 负责 大 局 


不 同 于 典型 的 软件 开发 者 , 软件 架构 角色 需要 通才 。 这 肯定 是 在 软件 项 目 起 航 阶段 掌舵 的 角 
色 ， 包 括 管理 非 功能 性 需求 ， 整 理 出 对 上 下 文 和 环境 因素 敏感 的 软件 设计 。 但 也 要 不 断 地 转向 ， 
因为 你 选择 的 航线 可 能 需要 在 途中 调整 。 毕 竞 , 敏捷 方法 已 经 向 我 们 展示 了 , 不 一 定 预 完 就 有 (或 
需要 ) 所 有 的 信息 。 


创建 一 个 最 初 的 愿景 , 交流， 并 在 整个 软件 开发 的 声明 周期 中 潜在 地 演化 它 ， 这些 对 一 个 成 
功 的 软件 项 目 是 必需 的 。 单 是 这 个 原因 ， 让 某 人 来 创建 这 个 愿景 ， 然 后 让 另 一 个 团队 去 〈 试 着 ) 
交付 ， 就 毫 无 意义 。 当 这 种 事情 发 生 时 ,初始 的 设计 方案 本 质 上 就 成 了 在 架构 师 和 开发 团队 中 传 
递 的 指挥 棒 。 这 很 低 效 ， 甚 至 无 效 ,文档 交换 也 意味 着 很 多 与 创建 愿景 相关 的 决策 上 下 文 也 丢失 
了 。 祈 祷 开 发 团队 永远 不 需要 问 任何 关于 设计 或 其 意图 的 问题 吧 ! 


真正 的 自 组 织 团队 不 会 有 这 样 的 问题 ,但 大 多 数 团队 还 没有 成 熟 到 那个 程度 ,在 整个 交付 中 ， 
要 有 人 负责 大 局 ,同时 为 保证 软件 顺利 交付 承担 责任 。 软 件 开 发 不 是 接力 运动 , 顺利 交付 也 不 是 
“实现 细节 ”。 


第 1 .2 章 
软件 架构 要 引入 控制 吗 


软件 架构 向 软件 项 目 引 入 结构 和 远见 , 是 否 也 引入 了 控制 ?如 果 答 案 是 肯定 的 , 那 控制 是 好 
还 是 坏 ? 


提供 指导 ， 追 求 一 致 性 


很 多 软件 架构 的 实践 都 会 向 软件 项 目 引入 指导 和 一 致 性 。 如 果 你 见 过 一 个 软件 系统 内 的 常见 
问题 或 横 切 关注 点 有 多 种 实现 方式 ， 就 会 明白 为 什么 这 很 重要 。 我 想起 不 少 案例 。 我 见 过 一 个 代 
码 库 里 用 到 了 好 多 个 ORM 框架 ， 还 有 的 软件 系统 有 好 几 种 跨 栈 的 组 建 配置 方式 ， 有 用 XML 文 
件 的 ， 也 有 用 数据 库 表 的 。 部 署 和 维护 这 些 系 统 太 有 挑战 性 了 。 


只 有 引入 一 定 程度 的 控制 和 约束 ， 比 如 , 阻止 团队 成 员 偏离 正轨 ,指导 和 一 致 性 才 可 能 成 为 
现实 。 如 果 你 为 了 满足 一 些 主要 的 非 功能 性 需求 ,专门 设计 了 一 个 分 布 式 软件 系统 ， 就 不 能 让 人 
把 数据 库 操 作 的 代码 写 在 网 页 中 。 控 制 也 可 以 只 是 保证 你 的 代码 库 有 一 个 清晰 一 致 的 结构 , 以 包 、 
命名 空间 、 组 件 、 层 等 形式 合理 地 组 织 你 的 代码 。 


控制 的 程度 


真正 的 问题 是 需要 引入 的 控制 量 。 一 种 方法 是 独裁 ,任何 人 都 不 能 擅自 做 决策 ; 另 一 种 方法 
是 放手 , 没有 人 会 得 到 任何 指导 。 在 软件 项 目 中 ,这 两 种 我 都 见 过 。 我 也 接手 过 混乱 的 项 目 ， 每 
个 人 基本 上 都 只 管 自己 的 设备 。 毫 不 意外 , 最 后 的 代码 库 简 直 一 团 糟 。 在 这 样 的 项 目 中 引入 控制 
真是 艰苦 的 工作 ， 如 果 这 个 团队 还 打算 交付 一 份 令 最 初 推动 者 满意 的 软件 ， 就 需要 控制 。 
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控制 因 文化 而 不 同 


我 也 注意 到 , 不 同 国家 和 文化 对 控制 的 看 法 也 不 尽 相 同 。 有 些 国家 ( 比如 英国 ) 就 认同 控制 
以 及 它 带 来 的 约束 ， 而 另 一 些 ( 比如 斯 堪 的 纳 维 亚 地 区 的 国家 ) 则 偏向 授权 和 主动 性 。 举 个 现实 
中 的 例子 ， 就 是 完全 控制 软件 项 目 使 用 的 全 部 技术 ( 从 编程 语言 到 登录 库 的 选择 )， 还 是 接受 团 
队 里 任何 人 做 的 决策 。 


操纵 杆 ， 而 非 按钮 


我 喜欢 把 控制 看 作 操 纵 杆 ， 而 不 是 茶 些 非 黑 即 白 、 只 有 两 种 状态 的 东西 。 一 问 是 由 你 独裁 的 
方法 ， 妃 一 端 则 宽松 得 多 。 两 者 之 间 你 可 调整 ， 这 让 你 能 够 在 需要 时 引入 足够 的 控制 。 那 么 ,你 
要 引入 多 少 控制 ? 我 得 承认 , 我 只 能 给 出 一 个 咨询 式 的 回答 , 在 不 清楚 的 情况 下 , 这 取决 于 以 下 
这 些 事 。 


口 团队 是 否 经 验 丰 富 ? 

口 团队 以 前 一 起 工作 过 吗 ? 

口 团队 有 和 多大? 

口 项 目 有 多 大 ? 

口 项 目的 需求 复杂 吗 ? 

口 有 没有 需要 考虑 的 复杂 的 非 功 能 需求 或 限制 ? 
口 日 常 的 讨论 是 什么 样 的 ? 

口 团队 或 已 有 的 代码 库 是 否 看 起 来 已 经 混乱 不 堪 ? 


D 等 等 。 


我 的 建议 是 ， 先 从 部 分 控制 开始 , 倾听 反馈 ,以 便 随 着 项 目的 推进 再 微调 。 如 果 团 队 老 是 问 
“为 什么 ”和 “怎么 办 ”"， 那 可 能 就 需要 更 多 指导 。 如 采 团 队 好 像 总 是 在 和 你 对 着 干 ， 可 能 你 就 是 
把 操纵 杆 推 得 太 多 了 。 这 没有 一 个 标准 的 答案 , 但 有 一 些 控制 是 好 事 ， 因 此 很 值得 花 几 分 钟 看 看 
你 的 团队 适合 引入 多 少 控制 。 
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我 们 这 个 行业 对 软件 架构 的 角色 真是 又 爱 义 恨 ， 因 为 架构 师 “ 闭 门 造 车 ”的 独裁 ,不 参加 构 
建 可 用 软件 的 任何 实际 工作 ， 很 多 组 织 干 脆 取 消 了 它 。 这 种 坏 名 声 损害 了 IT 行业 ， 阻 挠 了 项 目 
的 成 功 ， 需 要 改变 。 


开发 者 关注 底层 细节 


如 果 你 正在 一 个 软件 开发 项 目 中 工作 , 看 看 团队 其 他 人 了 吧 。 团队 的 结构 是 怎样 的 ? 每 个 人 的 
角色 和 责任 都 定义 好 了 吗 ? 谁 负责 大 局 ” 性能、 可 伸缩 性 、 可 用 性 、 安 全 性 等 由 谁 负责 ? 


我 们 都 梦想 在 这 样 的 团队 中 工作 : 所 有 人 都 经 验 丰富 ,从 代码 到 架构 ,对 软件 考虑 得 面 面 俱 
到 。 然 而 现实 并 非 如 此 。 我 合作 过 的 大 多 数 团队 ， 成 员 经 验 参 差 不 齐 ， 有 些 甚至 刚 接触 IT 这 一 
行 ， 另 一 些 则 “接触 过 几 次 "”。 作 为 软件 开发 者 ， 代 码 是 我 们 主要 的 关注 点 ， 但 如 果 你 的 团队 只 
关注 底层 细节 , 会 发 生 什么 ? 想象 有 一 个 用 上 了 所 有 最 新 编程 语言 特性 的 代码 库 , 代码 很 好 地 解 
耦 ,测试 也 完全 自动 化 。 这 个 代码 库 的 结构 和 格式 都 堪 称 完美 , 但 如 果 系 统 在 部 署 到 生产 环境 时 
有 可 伸缩 性 的 问题 ， 一 切 就 训 无 用 处 。 


闭门造车 的 独裁 架构 师 


软件 架构 角色 不 同 于 开发 者 角色 。 有 些 人 把 它 看 作 开 发 者 的 上 级 ， 有些 人 则 看 作 同 级 。 不 管 
你 怎么 看 ， 架 构 师 都 要 负责 “大 局 "”。 很 多 团队 了 解 软件 架构 的 重要 性 ， 会 找 来 一 个 有 着 受 人 尊 
敬 的 “架构 师 ” 头 衔 的 人 , 却 只 是 把 他 们 硬 塞 在 凌驾 于 团队 的 位 置 上 。 发 生 任何 事 ， 都 会 在 架构 
师 和 原本 要 一 起 工作 的 团队 之 间 造 成 巨大 的 鸿沟 ， 让 架构 师 立刻 被 孤立 起 来 。 
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拉 近 距离 
可 惜 , 很 多 软件 团队 里 ,在 开发 团队 和 架构 师 之 间 都 有 这 个 不 必要 的 鸿沟 ,特别 是 当 架 构 师 
被 看 作 是 只 会 下 命令 的 独裁 者 。 这 导致 了 几 个 问题 : 
口 不 管 架 构 师 的 决策 是 否 正 确 ， 开 发 团队 都 不 尊重 他 ; 
口 开发 团队 变 得 缺乏 积极 性 ; 
口 重要 决策 因为 职责 不 明 而 无 人 负责 ; 
口 因为 没有 人 负责 大 局 ,项 目 最 终 匣 不 堪 言 。 


幸好 ， 有 一 些 简 单 的 方法 能 从 两 方面 解决 这 个 问题 ， 毕 竞 ， 软 件 开 发 是 一 个 团队 行为 。 


如 果 你 是 软件 架构 师 


口 包容 与 合作 : 让 开发 团队 参与 软件 架构 的 过 程 ， 帮 助 他 们 了 解 大 局 ， 认 同 你 所 做 的 决策 。 
确保 每 个 人 都 明白 决策 背后 的 原理 和 目的 ， 会 对 此 有 所 帮助 。 

口 动手 : 如 果 可 能 的 话 ， 参 与 一 些 项 目的 日 常 开发 工作 来 提高 你 对 架构 交付 的 理解 。 根 据 
你 的 角色 和 团队 规模 ， 这 可 能 会 不 太 现 实 ， 那 就 通过 其 他 方式 来 了 解 底层 的 进展 ， 比 如 
协助 设计 和 代码 评审 。 了 解 软 件 的 底层 如 何 工作 会 让 你 更 透彻 地 了 解 开 发 团队 对 架构 ( 比 
如 : 他 们 是 否 对 其 视而不见 ) 的 感受 ， 也 会 为 你 提供 有 价值 的 信息 ， 可 以 用 来 更 好 地 塑 
造影 响 架 构 。 如 果 开 发 者 感到 痛苦 ， 你 也 要 感同身受 。 


如 果 你 是 软件 开发 者 


口 了 解 大 局 : 花 些 时 间 去 了 解 大 局 将 帮助 你 了 解 做 出 架构 决策 的 语 境 ， 增 强 你 对 系统 整体 

的 理解 。 

口 挑战 架构 决策 : 有 了 对 大 局 的 了 解 ， 你 现在 就 有 机 会 挑战 眼前 的 架构 决策 。 架 构 应 该 是 
一 个 合作 的 过 程 ， 而 不 是 由 那些 不 参与 项 目 日 常 工作 的 人 说 了 算 。 如 果 你 发 现 有 些 事情 
你 不 理解 或 不 喜欢 ， 挑 战 它 。 

口 申请 参与 : 很 多 项 目 都 有 一 个 负责 架构 的 架构 师 , 这 个 人 通常 会 承担 所 有 的 “架构 工作 ”。 

如 果 你 是 一 个 开发 者 ， 想 要 参与 其 中 ， 提 出 来 。 你 说 不 定 帮 了 架构 师 一 个 忙 


软件 架构 的 合作 方式 


我 这 里 已 经 谈 到 的 内 容 很 容易 适用 于 中 小 型 项 目 团队 ， 但 对 于 大 型 团 了 从， 事情 就 变 得 复杂 了 。 
言 外 之 意 ， 大 型 团队 意味 着 更 大 的 项 目 ， 更 大 的 项 目 意味 着 更 大 的 “大 局 "。 无 论 项 目 规模 如 何 ， 
确保 大 局 不 被 忽视 是 成 功 的 关键 , 而 这 个 重任 往往 落 在 架构 师 的 肩 上 。 减少 开发 者 和 架构 师 之 间 不 
必要 的 鸿沟 , 可 以 让 大 多 数 软件 团队 从 中 获 益 ,双方 都 可 以 努力 减少 这 个 鸿沟 。 开 发 者 可 以 增加 他 
们 的 架构 意识 , 而 架构 师 可 以 加 强 与 团队 其 他 人 的 合作 。 要 确保 你 注意 到 了 鸿沟 , 其 他 人 也 会 跟随 。 
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敏捷 和 软件 技艺 是 我 们 努力 改进 和 推动 软件 行业 向 前 的 两 个 非常 好 的 例子 ,我 们 花 了 很 多 时 
间 谈 论 编写 代码 、 自 动 化 测试 、 自 动 化 部 署 、 工 具 、 各 种 技术 ,以 及 所 有 相关 的 流程 。 这 很 有 意 
义 ， 因 为 最 终 目 标 是 通过 软件 让 人 们 获 益 ,而 可 用 的 软件 是 关键 。 但 我 们 不 应 该 忘记 ,在 软件 开 
发 的 流程 中 某 些 层面 是 很 少 有 人 真正 有 经 验 的 。 想 想 你 将 如 何 回答 下 列 问题 。 


(1) 你 上 次 写 代码 是 什么 时 候 ? 
口 今天 早 些 时 候 就 写 过 ， 我 是 软件 开发 者 ， 所 以 这 是 我 工作 的 一 部 分 。 
(2) 你 上 次 重 构 是 什么 时 候 ? 
口 我 一 直 注 意 让 自己 的 代码 尽 可 能 好 ， 这 包括 必要 的 重 构 。 提 取 方 法 、 重 命名 、 上 升 、 
下 降 …… 这 些 我 都 知道 。 
(3) 你 上 次 测试 你 的 代码 是 什么 时 候 ? 
口 过 去 , 我 们 会 在 编写 产品 代码 的 过 程 当 中 或 之 后 编写 自动 化 测试 , 来 进行 持续 的 测试 。 
单元 测试 、 集 成 测试 和 验收 测试 我 们 都 会 用 到 。 
(4) 你 上 次 设计 东西 是 什么 时 候 ? 
口 我 一 直 在 做 ， 作 为 软件 开发 者 ， 这 是 我 工作 的 一 部 分 。 在 编码 之 前 ， 我 需要 思考 它 会 
如 何 工 作 ， 不管 是 画 草 图 还 是 使 用 TDD。 


(5) 你 上 次 从 零 开 始 设计 一 个 软件 系统 是 什么 时 候 ? 我 的 意思 是 ， 承 接 一 系列 明确 的 需求 ， 
真正 从 无 到 有 的 创建 ? 


几 
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口 好 吧 ， 在 我 目前 的 项 目 没有 太 多 机 会 ,但 在 业余 时 间 我 会 为 开源 项 目 工 作 。 只 是 我 自己 
用 的 。 


(6) 你 上 次 从 零 开始 设计 一 个 会 由 一 个 团队 来 实现 的 软件 系统 是 什么 时 候 ? 
口 嗯 ， 那 不 是 我 做 的 。 


面 对 现 实 吧 , 无 论 预 完 设 计 还 是 演化 设计 , 也 不 管 是 单打 独 斗 还 是 集团 作战 ， 大 多 数 软件 开 
发 者 都 不 会 频繁 地 在 一 张 白 纸 上 从 无 到 有 地 设计 软件 。 


旧 导 、 辅 导 和 师 徒 关系 


在 大 多 数 软件 开发 项 目 中 , 指导 和 辅导 是 一 项 被 忽视 的 活动 , 很 多 团队 成 员 没 有 得 到 所 需 的 
支持 。 技 术 领 导 力 就 是 要 引导 整个 项 目 ， 有 时 候 个 人 需要 协助 。 除 此 之 外 ,指导 和 辅导 提供 了 
种 方式 来 增强 人 们 的 技能 ， 帮 助 他 们 完善 自己 的 职业 生涯 。 这 种 协助 有 时 候 是 技术 性 的 ,有 时 候 
是 软 技 能 。 从 技术 的 角度 来 看 ,为 什么 承担 软件 架构 角色 的 人 不 应 该 帮 着 指导 和 辅导 呢 ? 我 认识 
的 大 多 数 架构 师 正 是 因为 他 们 在 一 个 或 多 个 技术 领域 有 大 量 的 经 验 才 当 上 架构 师 的 。 既 然 是 这 
样 , 为 什么 那些 架构 师 不 应 该 通过 分 享 一 些 自己 的 经 验 来 帮助 别人 ? 学 徒 模式 正 是 过 去 建造 大 师 
传承 技艺 的 方式 。 


我 们 正在 失去 技术 导师 


可 悲 的 是 , 在 我 们 的 行业 里 许多 开发 者 为 了 在 企业 晋升 机 制 中 有 所 发 展 , 被 迫 转向 非 技术 的 
管理 岗位 。 讽 刺 的 是 ,被 迫 离开 技术 岗位 的 往往 是 最 优秀 和 最 资深 的 技术 人 员 ， 而 软件 团队 中 则 
失去 了 最 有 价值 的 技术 领导 、 架 构 师 和 导师 。 今 天 的 开发 者 还 会 在 将 来 继续 重 蹈 覆 国 。 


软件 团队 需要 休息 


许多 团队 失去 了 最 资深 的 技术 人 员 , 留 在 团队 中 的 人 本 来 就 已 经 在 尽力 平衡 所 有 常规 的 项 目 
限制 和 IT 行业 风潮 〈 敏 捷 、 技 艺 、 云 、 富 互联 网 UI、 函 数 式 编程 ， 等 等 ) 带 来 的 压力 ， 而 这 又 
给 他 们 增加 了 更 多 的 工作 量 。 很 多 团队 意识 到 他 们 应 该 努力 提高 ， 但 却 没有 时 间或 缺乏 动力 。 


为 了 提高 ， 软 件 开发 团队 需要 一 些 时 间 远 离 日 常 工作 ,进行 思考 , 但 他 们 也 需要 保持 对 软件 
开发 流程 各 个 方面 的 关注 。 行 业 的 炒作 确实 很 容易 迷惑 人 , 但 应 该 自问 这 是 否 比 确保 能 良好 务实 
地 落地 更 重要 。 

编码 经 验 很 容易 积累 ， 有 很 多 方式 来 练习 这 项 技能 。 然而 ,从头 开始 设计 一 些 将 会 由 团队 来 
实现 的 东西 ， 就 不 是 很 多 团队 都 会 教授 或 实践 的 事情 了 。 拜 典型 的 企业 晋升 机 制 所 赐 , 很 多 技术 
导师 都 消失 了 ， 让 开发 者 上 哪儿 去 获得 这 种 经 验 ? 未 来 的 软件 架构 师 从 哪里 来 ? 
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很 多 软件 团队 都 朝 着 敏捷 和 自 组 织 努 力 , 在 这 种 对 现代 软件 开发 团队 的 描述 中 , 软件 架构 角 
色 如 何 融入 并 不 是 显而易见 的 。 


每 个 人 都 是 架构 师 


在 Extreme Programming Annealed" 中 ， 格 伦 : 范 德 堡 (Glenn Vanderburg ) 讨论 了 极限 编程 实践 
适用 的 层次 ， 他 强调 了 架构 和 集体 所 有 制 之 间 的 联系 。 当 我 们 谈论 集体 所 有 制 ? 时 ， 通 常 指 的 是 集 
体 拥 有 代码 , 以 便 团队 中 任何 人 都 有 权 做 出 改动 。 这 种 方式 奏效 暗示 团队 中 每 个 人 至 少 都 对 “大 局 ” 
有 一 些 基 本 的 了 解 。 想 想 你 目前 的 项 目 ， 跳 转 到 代码 库 的 任何 一 部 分 ， 你 都 明白 发 生 了 什么 吗 ? 


想象 一 下 ， 如果 你 有 一 队 经 验 丰 富 、 能 够 在 大 局 内 外 自如 切换 的 软件 开发 者 , 一 队 真正 会 动 
手 的 架构 师 ， 这 样 的 团队 太 棒 了 ， 所 有 通常 会 跟 软件 架构 联系 起 来 的 元 素 〈 非 功能 需求 、 约 束 ， 
等 等 ) 都 会 得 到 解决 ， 不 会 漏 掉 任 何 一 样 。 从 技术 的 角度 来 看 ， 这 就 是 一 个 自 组 织 的 团队 。 


除非 他 们 有 其 他 身份 


对 自 组 织 团队 的 想法 , 我 有 一 个 大 问题 , 我 们 在 行业 中 谈论 了 很 多 , 但 很 少 看 到 实践 。 这 可 
能 是 在 咨询 的 环境 中 工作 的 副作用 , 因为 我 的 团队 总 是 随 着 项 目 而 变化 ,而 且 我 不 太 可 能 跟 某 一 
个 客户 在 一 起 超过 几 个 月 。 或 者 , 我 怀疑 ,真正 的 自 组 织 团队 非常 少 。 把 自 组 织 作 为 努力 方向 是 
值得 尊敬 的 ， 但 对 很 多 软件 团队 而 言 ， 这 就 像 是 还 没 学 会 走 就 想 跑 了 。 


GD http:/www.vanderburg.org/Writing/xpannealed.pdf 


© http:/www.extremeprogramming.org/rules/collective.html 
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在 “Notes to a software team leader” “中 ， 罗 伊 ， 奥 谢 洛 夫 (Roy Osherove ) 描述 了 他 的 “ 弹 
性 领导 ”概念 ， 这 种 领导 风格 需要 根据 团队 的 成 熟 度 有 所 变化 。 罗 伊 用 一 个 简单 的 模型 对 团队 成 
熟 度 做 了 分 类 ， 每 个 等 级 需要 不 同 的 领导 风格 。 


(1) 生存 型 (混乱 ): 需要 一 种 直接 指挥 和 控制 的 领导 风格 。 
(2) 学 习 型 : 需要 一 种 指导 的 领导 风格 。 
(3) 自 组 织 型 : 需要 简易 化 来 确保 平衡 不 受 影响 。 


就 像 我 说 的 ,团队 里 每 个 人 都 是 经 验 丰 富 的 软件 开发 者 和 架构 师 , 那 就 太 棒 了 , 但 我 还 没 见 
过 这 样 的 团队 。 大 多 数 项 目的 团队 连 一 个 对 “大 局 ”之 类 的 东西 有 经 验 的 人 都 没有 , 一 团 乱 的 代 
码 库 、 不 明确 的 设计 、 很 慢 的 系统 ， 类 似 这 些 都 是 明证 。 从 技术 角度 来 看 ， 这 种 情况 最 为 多 见 ， 
我 建议 团队 中 由 一 个 人 来 承担 软件 架构 角色 的 责任 。 


罗 伊 举 了 流程 经 理 角色 的 例子 。 在 成 熟 的 初始 阶段 , 一 个 人 承担 流程 经 理 的 角色 来 帮助 团队 
向 正确 方向 前 进 ， 这 将 使 团队 受益 。 另 一 方面 , 自 组 织 团 队 不 需要 别人 告诉 他 们 做 什么 。 名 字 就 
是 线索 ; 从 定义 上 ,他 们 是 自 组 织 的 ， 可 以 自己 承担 这 个 角色 。 我 想 说 ， 软 件 架构 的 角色 是 同样 
的 ， 因 此 技术 领导 的 角色 也 是 。 


敏捷 需要 架构 吗 


可 惜 , 许多 团队 把 “大 局 ”上 的 技术 技能 看 作 一 种 不 必要 的 收 恶 ， 而 不 是 重要 的 补充 ,可 能 是 
因为 他 们 过 去 深 受 大 型 预先 设计 之 害 。 有 些 人 也 过 于 渴望 “敏捷 ”"， 以 至 于 忽略 软件 开发 流程 的 其 
他 方面 。 接 旺 而 至 的 是 混乱 而 非 自 组 织 , 这 样 的 团队 也 面临 着 需要 更 直接 的 领导 方式 的 挑战 。 毕 竞 ， 
他 们 在 努力 变 得 敏捷 。 单个 点 负责 项 目的 技术 层面 , 也 跟 他 们 对 敏捷 团队 的 想象 相 冲 突 。 这 种 冲突 
使 人 认为 敏捷 和 架构 是 对 立 的 : 你 只 能 拥有 其 中 一 个 ,与 敏捷 对 立 的 不 是 架构 , 而 是 大 型 预先 设计 。 


人 敏捷 软件 项 目 仍然 需要 架构 ,因为 那些 围绕 复杂 非 功能 需求 和 约束 的 棘手 问题 不 会 消失 , 只 
是 对 架构 角色 的 执行 不 同 。 


集体 代码 所 有 制 ， 每 个 人 都 要 能 在 架构 的 层次 上 工作 ， 因 此 每 个 人 某 种 程度 上 都 是 架构 师 。 
还 不 是 自 组 织 阶段 的 团队 如 果 试 图 跑 太 快 , 就 会 陷入 挣扎 。 尽管 人 们 的 愿望 是 变 得 敏捷 ,集体 代 
码 所 有 制 和 架构 角色 的 分 配 都 有 可 能 阻碍 混乱 的 团队 , 而 不 是 帮助 他 们 。 混乱 的 团队 需要 更 直接 
的 领导 方式 ,单个 点 负责 软件 项 目的 技术 层面 , 将 使 他 们 受益 。 换 句 话 说, 他们 会 受益 于 一 个 人 
负责 软件 架构 的 角色 。 理 想 的 话 ， 这 个 人 会 指导 别人 ， 让 他 们 也 能 以 这 个 角色 产生 帮助 。 


软件 架构 师 要 一 个 还 是 多 个 ? 一 个 人 承担 责任 还 是 团队 共同 分 担 ? 不论 敏 捷 与 否 , 软件 架构 
的 角色 都 是 存在 的 。 只 有 所 处 语 境 会 告诉 你 正确 的 答案 。 


GD http://leanpub.com/teamleader 
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我 的 职业 生涯 大 部 分 都 是 在 IT 咨询 公司 工作 ， 在 那里 我 要 么 在 外 包 合同 下 为 客户 构建 软件 
系统 ， 要 么 是 客户 -供应 商 混合 团队 的 一 份子 ( 通常 被 称 为 “劳务 派 遗 ””)。 在 咨询 的 语 境 中 担 
任 软 件 架构 的 角色 ， 基 本 上 和 在 其 他 语 境 中 是 一 样 的 ， 然 而 也 有 一 些 潜 在 的 问题 需要 注意 。 


领域 知识 


对 业务 领域 的 了 解 必 不 可 少 。 如 果 在 金融 行业 工作 ， 对 行业 内 跟 你 相关 的 部 分 ( 比如 ， 基 金 
管理 、 投 资 银行 、 零 售 银行 等 ) 是 如 何 运作 的 ， 你 应 该 有 所 了 解 。 大 部 分 业务 领域 都 比 它们 应 有 
的 样子 更 复杂 ， 即 使 看 似 简单 的 领域 也 会 让 你 吃惊 。 我 记得 第 一 次 看 到 渡轮 和 酒店 领域 , 就 惊讶 
地 发 现 并 不 只 是 预订 渡轮 座位 或 酒店 房间 那么 简单 。 对 业务 领域 的 了 解 可 以 帮助 你 更 好 地 理解 目 
标 和 建立 成 功 的 软件 产品 。 


这 提出 了 一 个 有 趣 的 问题 。 对 业务 领域 的 深厚 知识 ， 只 来 自 于 在 这 个 领域 内 长 时 间 的 工作 ， 
但 大 多 数 咨询 师 跟 不 同 的 客户 、 团 队 和 业务 领域 打交道 是 很 常见 的 。 因 此 ,期望 咨询 师 们 具备 深 
厚 的 领域 知识 算 公平 吗 ? 

我 见 过 一 些 方 法 。 首 先 就 是 把 自己 的 咨询 工作 限制 在 单一 的 业务 领域 ,这 样 就 能 获得 这 个 
业务 领域 深入 的 工作 知识 。 举 个 例子 ,我 工作 过 的 许多 I 芽 咨 询 机 构 都 专注 于 投资 银行 业 ， 它 们 
的 咨询 师 在 各 个 投资 银行 间 游 走 。 这 肯定 是 确保 咨询 师 了 解 业务 领域 的 一 种 有 效 方式 ， 但 我 不 


9 外包 主要 分 两 类 : 也 就 是 我 们 常 说 的 “ 包 出 去 ”和 “ 包 进 来 "。“ 包 出 去 ”是 发 包 方 把 工作 委托 给 外 部 的 人 或 团 
“ 包 进 来 ”就 是 这 里 所 说 的 “劳务 派遣”， 即 外 包 人 员 在 工作 期 间 进驻 发 包 方 的 团队 。 一 一 译 者 注 


| 


队 。 
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是 特别 喜欢 。 向 我 过 去 合作 过 的 一 些 咨询 师 提供 投资 银行 的 外 部 咨询 工作 时 ， 他 们 实际 上 很 生 
气 。 在 跟 其 他 咨询 师 做 比较 时 ， 这些 人 通常 会 认为 他 们 深厚 的 业务 领域 知识 是 关键 差异 或 者 说 
独特 卖点 。 


看 看 我 的 书架 就 会 发 现 ,我 对 技术 的 兴趣 远 远 超过 任何 业务 领域 。 如 果 我 想 在 一 家 银行 工作 ， 
我 会 为 银行 工作 ， 而 非 咨询 机 构 。 因 此 ,我 很 高 兴 能 定期 更 换 业 务 领域 ， 这 提供 了 一 定 程度 的 变 
化 ,很 少 能 在 单个 领域 中 工作 获得 。 我 也 发 现 观察 其 他 行业 如 何 解决 相似 问题 很 有 意思 ,这 本 喘 
也 带 来 了 很 多 思想 碰撞 的 机 会 。 当 然 ， 缺 点 就 是 我 对 任何 特定 领域 的 知识 都 不 如 在 那个 业务 领域 
中 全 职工 作 的 人 。 


为 了 防止 这 一 问题 ,我 相信 ， 有 一 种 技能 可 以 让 我 们 能 够 快速 精通 一 个 新 的 业务 领域 。 这 正 
是 我 的 方法 。 如 果 以 咨询 的 身份 从 事 软件 架构 , 你 需要 敏锐 的 分 析 能 力 来 理解 业务 领域 的 关键 部 
分 ， 而 不 陷入 分 析 竣 疾 的 恶性 循环 。 


权威 


软件 架构 角色 需要 引入 多 少 控 制 ， 取 决 于 和 你 一 起 工作 的 软件 开发 团队 的 类 型 。 然 而 团队 
通常 会 提出 另 一 些 挑战 ， 特 别 是 如 果 你 以 软件 架构 咨询 师 的 身份 和 客户 的 内 部 开发 者 团队 一 起 
工作 。 


如 果 你 负责 一 个 软件 系统 的 软件 架构 和 技术 交付 ,就 必须 有 决策 权 。 如 果 有 责任 却 没有 权力 ， 
并 因此 不 断 为 决策 寻求 许可 ， 那 就 像 是 在 一 条 崎 贝 不 平 的 道路 上 行驶 。 


软件 架构 的 角色 意味 着 技术 领导 力 , 也 就 是 你 要 让 整个 团队 朝 着 同一 方向 前 进 。 如 果 你 不 是 
一 队 软 件 开发 者 的 直接 上 司 , 口述 指导 不 太 可 能 很 有 效 。 如 果 你 是 客户 团队 的 补充 , 这 种 情况 经 
常 发 生 。 这 就 是 施展 软 技能 的 地 方 ,特别 是 建设 关系 、 建 立信 任 和 激励 团队 相关 的 软 技能 。 我 发 
现 要 做 一 个 写 代 码 的 实践 派 架 构 师 ， 取 得 成 果 也 要 走 很 长 的 路 。 


(1) 软件 架构 和 软件 开发 角色 的 区 别 是 什么 ? 

(2) 软件 架构 的 角色 都 做 些 什 么 ”这 个 定义 是 基于 你 团队 的 现状 还 是 理想 状态 ?如 果 是 后 
者 ， 你 的 团队 可 以 做 出 什么 改变 ? 

(3) 为 什么 承担 软件 架构 角色 的 人 理解 所 用 的 技术 很 重要 ?你 会 雇用 一 个 不 懂 技 术 的 软件 架 
构 师 吗 ? 

(4) 如 果 你 是 所 在 项 目的 软件 架构 师 ， 编 码 在 你 的 工作 中 占 多 大 比例 ?是 太 多 还 是 太 少 ? 

(5) 作为 一 个 软件 架构 师 ， 如 果 不 能 编码 ， 你 还 有 其 他 方式 接触 到 项 目的 底层 工作 吗 ? 你 有 
其 他 方式 更 新 你 的 技术 吗 ? 

(6) 为 什么 技术 知识 的 广度 和 深度 都 很 重要 ? 

(7) 你 认为 自己 掌握 了 承担 软件 架构 角色 所 需 的 软 技能 吗 ” 如 果 没 有 ， 你 会 在 哪 方面 改进 ? 
为 什么 ， 以 及 怎么 做 ? 

(8) 从 软件 架构 的 观点 来 说 ， 你 目前 的 软件 项 目 有 足够 的 指导 和 控制 吗 ? 是 不 是 太 多 了 ? 

(9) 为 什么 合作 是 软件 架构 角色 的 一 个 重要 组 成 部 分 ? 你 的 团队 在 这 方面 做 得 够 不 够 ”如 果 
还 不 够 ,为 什么 ? 

(10) 你 的 团队 中 有 足够 的 指导 和 辅导 吗 ? 你 在 提供 或 接受 吗 ? 

(11) 软件 架构 的 角色 如 何 融 入 敏捷 项 目 和 自 组 织 团队 ? 

(12) 作为 软件 架构 角色 的 新 人 ， 你 遭遇 过 哪些 困难 ? 

(13) 在 你 的 团队 或 组 织 中 ， 对 软件 架构 有 定义 好 的 “参考 条 例 ” 吗 ? 如 果 有 ， 每 个 人 都 明白 
了 吗 ? 如 果 没 有 ,那么 为 了 返 清 架构 师 的 角色 和 责任 创建 一 个 条 例 ， 是 否 有 价值 ? 


设计 软件 


这 邵 分 是 天 于 设计 软件 的 整个 流程 ， 特 别 是 开始 


遍 码 前 真正 需要 思考 的 事情 。 


Pay 


第 纪 7 说 
架构 驱动 力 


不 管 你 采用 哪 种 流程 ( 传统 和 计划 了 驱动， 或 者 轻 量 和 可 适 配 的 )， 都 有 一 套 常 见 的 东西 真正 
了 驱动、 影响 和 塑造 了 最 终 的 软件 架构 。 


1. 功能 需求 


为 了 设计 软件 ,你 需要 了 人 解 要 满足 的 目标 。 如 果 这 听 起 来 天 经 地 义 ,， 那 是 因为 确实 如 此 。 话 
虽 如 此 ,但 有 的 团队 对 软件 应 该 向 最 终 用 户 提供 的 特性 还 没有 高 层次 理解 , 就 设计 其 至 构建 软件 。 
有 人 可 能 会 称 之 为 敏捷 ， 但 我 说 这 叫 思 春 。 特 性 或 用 户 故 事 清单 (比如 Scrum 产品 订单 ")， 即 使 
粗糙 短小 ， 也 是 必 不 可 少 的 。 需 求 驱 动 架 构 。 

2. 质量 属性 

非 功 能 需求 代表 的 质量 属性 反映 了 服务 等 级 ， 如 性 能 、 可 伸缩 性 、 可 用 性 、 安 全 性 等 。 这 些 
属性 主要 是 技术 方面 的 ， 可 以 对 最 终 的 架构 产生 巨大 影响 ， 特 别 是 如 果 你 正在 构建 “高 性 能 ” 系 
统 ， 或 者 你 想 达到 “和 谷歌 级 ”的 运行 规模 。 实 现 非 功能 需求 的 技术 解决 方案 通常 是 交叉 的 ,因此 
需要 合并 到 你 所 构建 系统 的 基础 中 。 向 已 有 的 代码 库 加 入 高 性 能 、 可 伸缩 性 、 安 全 性 、 可 用 性 等 
通常 极其 困难 且 耗 时 。 

3. 约束 


我 们 生活 在 有 约束 的 现实 世界 中 。 例 如 , 你 任职 的 组 织 可 能 对 技术 选 型 、 部 署 平台 等 有 一 系 
列 细致 的 约束 ， 能 做 什么 ， 不 能 做 什么 。 


GD http://en.wikipedia.org/wiki/Scrum 9%28software_development%29#Product backlog 
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4. 原则 


约束 通常 是 强加 于 你 的 , 而 原则 是 你 为 了 将 一 致 性 和 清晰 度 引 入 最 终 代码 库 而 想 采 用 的 原则 
( 例如 编码 规范 、 自 动 化 测试 的 使 用 等 ) 或 架构 的 原则 ( 如 分 层 策略 ， 架 构 模 式 等 )。 

5. 理解 影响 

任何 时 候 当 你 开始 为 一 个 新 的 软件 系统 工作 或 扩展 已 有 的 软件 系统 ， 在 高 层次 上 理解 需求 、 
约束 和 原则 都 至 关 重 要 。 为 什么 ? 简 言 之 ， 要 开始 设计 选 型 ， 这 是 你 所 需 知 识 的 基本 水 平 。 

首先 , 了 解 这 些 东 西 可 以 帮助 减少 摆 在 你 面前 的 可 选项 , 特别 是 如 果 你 发 现 驱 动力 包括 了 复 
杂 的 非 功 能 性 需求 或 者 像 部 署 平台 的 限制 之 类 的 主要 约束 。T. S. 艾 略 特 (TS. Eliot ) 说 过 

当 被 迫 工 作 在 一 个 严格 的 框架 下 ， 想 象 力 被 迫 发 挥 到 极限 ， 送 发 出 丰富 的 点 子 。 完 

全 的 自由 可 能 会 让 工作 变 得 杂乱 无 序 。 

其 次 ,也 许 是 最 重要 的 ， 那 就 是 根据 特定 的 目标 和 语 境 ， 做 出 “明智 ”的 设计 决策 。 如 果 不 
了 解 金 融 风险 系统 相关 的 性 能 ( 比如 计算 复杂 度 )、 可 伸缩 性 ( 比如 数据 量 )、 安 全 性 和 审计 等 需 
求 ， 就 开始 为 其 设计 解决 方案 ， 你 设计 出 的 解决 方案 很 可 能 不 符合 目标 。 

软件 架构 谈论 的 是 重要 的 设计 决策 ,其 重要 性 以 变动 的 成 本 来 衡量 。 对 于 那些 从 根本 上 塑造 
了 最 终 软件 架构 的 重要 决策 而 言 , 起 点 是 在 高 层次 上 对 需求 、 约 束 和 原则 的 理解 . 早 些 理解 它们 ， 
将 有 助 于 避免 将 来 昂贵 的 返工 。 
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当 你 收集 需求 时 ， 人 们 会 很 乐意 给 你 一 个 愿望 清单 ， 写 满 了 他 们 想 要 软件 系统 完成 的 事 ; 也 
有 完善 的 方法 以 用 户 故 事 、 用 例 、 传 统 的 需求 规格 书 、 验 收 标准 等 形式 来 捕捉 这 一 信息 。 那 么 ， 
那些 讨厌 的 “ 非 功能 性 需求 ” 呢 ? 


非 功能 性 需求 通常 被 看 作 是 “能 力 ”， 主 要 跟 服务 质量 有 关 。 按 理 说 ， 比 非 功能 性 需求 更 好 
的 说 法 是 “系统 特征 ”或 “质量 属性 ”， 但 不 太 常 用 。 下 面 大 致 列 出 了 和 常见 的 质量 属性 。 


性 能 就 是 一 个 东西 有 多 快 ， 通常 指 响应 时 间或 延迟 。 


口 响应 时 间 : 从 发 出 请 求 到 收 到 响应 所 用 的 时 间 ， 比 如 用 户 点 击 网 页 中 的 超 链接 或 桌面 应 
用 程序 中 的 按钮 。 
口 延迟 : 消息 从 A 点 到 B 点 ， 通 过 你 的 系统 所 用 的 时 间 。 


就 算 构 建 的 不 是 “高 性 能 ”软件 系统 ， 性 能 也 可 应 用 于 Web 应 用 程序 、 桌 面 应 用 程序 、 面 
向 服务 架构 、 消 息 系统 等 几乎 所 有 你 要 构建 的 软件 系统 。 如 果 用 户 说 你 的 软件 “ 太 慢 "， 你 就 明 
日 为 什么 有 一 些 性 能 的 概念 很 重要 。 

2. 可 伸缩 性 


可 伸缩 性 基本 上 就 是 软件 处 理 更 多 用 户 、 请 求 、 数 据 、 消 息 等 的 能 力 。 可 伸缩 性 和 并 发 机 制 
密 不 可 分 ， 因 此 能 在 相同 的 时 间 内 处 理 更 多 的 东西 〈 比如 每 秒 的 请 求 )。 
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3. 可 用 性 

可 用 性 是 软件 对 服务 请 求 的 可 操作 和 可 见 程 度 。 你 常会 看 到 用 “9” 来 衡量 或 指 代 可 用 性 ， 
如 99.99% (“四 个 9”) 或 99.999% (“五 个 9”)。 这 些 数 字 指 的 是 正常 运行 时 间 的 百分比 。 硬币 的 
男 一 面 是 可 以 容忍 的 停机 时 间 。99.9% (“三 个 9”) 的 正常 运行 时 间 意 味 着 留 给 计划 维护 、 升 级 
和 意外 故障 的 时 间 每 天 只 有 1 分 多 钟 。 

4. 安全 性 

安全 性 涵盖 了 从 认证 和 授权 到 数据 在 运输 和 储存 中 的 机 密 性 的 所 有 事情 。 和 性 能 一 样 , 安全 
性 很 有 可 能 在 一 定 程度 上 对 你 很 重要 。 对 于 部 署 到 互联 网 的 Web 应 用 程序 ， 安 全 性 应 该 被 视 为 
最 基础 的 东西 。 开 放 Web 应 用 程序 安全 项 目 (OWASP,， Open Web Application Security Project ) ” 
是 学 习 安 全 性 的 一 个 很 好 的 出 发 点 。 

5. 灾难 恢复 

如 果 失 去 一 个 运行 了 你 的 软件 的 硬盘 、 服 务 器 或 数据 中 心 , 会 发 生 什 么 ? 灾难 恢复 处 理 的 就 
是 这 些 。 如 果 你 的 软件 系统 至 关 重 要 ， 就 会 经 常 听 到 人 们 谈论 业务 连续 性 过 程 , 也 就 是 发 生 灾难 
事件 时 ， 应 该 做 什么 才能 保持 持续 运行 的 状态 。 

6. 可 访问 性 

可 访问 性 通常 是 指 像 W3C 的 可 访问 性 标准 ”这 样 的 东西 , 指 的 是 如 何 让 视觉 障碍 之 类 的 残疾 
人 也 能 使 用 你 的 软件 。 

7. 监测 

有 些 组 织 对 于 应 该 如 何 监测 软件 系统 才能 确保 它们 正常 运行 和 满足 服务 请 求 ， 有 特定 的 需 
求 。 这 可 能 包括 将 软件 与 平台 特定 的 监测 功能 ( 比如 Java 平台 的 JMX ) 集成 ， 或 发 生 故 障 时 向 
集中 监测 仪表 发 送 警 报 〈 比如 通过 SNMP )。 

8. 管理 


监测 通常 提供 一 个 软件 系统 的 只 读 视 图 ， 有 时 会 有 运行 时 管理 需求 。 例 如 ， 有 必要 的 话 ， 暴 
露 一 些 功能 ， 使 得 操作 人 员 能 够 修改 系统 运行 时 的 拓扑 结构 或 配置 元 素 ， 刷 新 只 读 缓存 等 。 


9. 审 计 
人 们 往往 需要 一 个 引起 软件 系统 中 数据 或 行为 变化 的 事件 的 日 志 ( 即 审计 日 志 ) 特别 是 涉 
及 钱 的 时 候 。 通 常 这 些 日 志 需 要 捕获 与 变动 由 谁 做 出 什么 时 候 做 出 以 及 为 什么 做 出 相关 的 信息 。 


CD https:Wwww.owasp.org 
© http:/www.w3.org/standards/webdesign/accessibility 
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变动 本 身 ( 即 变 动 前 后 的 值 ) 往往 也 需要 记录 。 

10. 灵活 性 

灵活 性 是 一 个 有 点 滥用 和 含混 的 术语 ， 指 的 是 软件 执行 多 个 任务 ， 或 以 不 同方 式 执行 单个 任 
务 的 “灵活 性 ”。 一 个 很 好 的 灵活 性 需求 的 例子 是 非 技 术 人 员 修 改 软件 内 部 使 用 的 业务 规则 的 能 力 。 

11. 可 扩展 性 

可 扩展 性 也 是 滥用 和 模糊 的 ， 但 它 指 的 是 扩展 软件 使 其 可 以 做 一 些 现在 还 不 能 做 的 事 的 能 
力 ， 也 许 是 通过 使 用 插件 和 API。 一 些 市 面 上 的 产品 (如 微软 Dynamics CRM ) 允许 非 技术 用 户 
扩展 存储 的 数据 和 改变 其 他 用 户 与 数据 交互 的 方式 。 

12. 可 维护 性 

可 维护 性 往往 被 认为 是 一 个 需求 , 但 这 到 底 是 什么 意思 ?作为 软件 开发 者 , 我 们 通常 会 努力 
打造 “可 维护 ”的 软件 ， 但 值得 我 们 思考 的 是 ， 代 码 库 以 后 将 由 谁 来 维护 。 可 维护 性 很 难 量化 ， 
所 以 我 宁愿 思考 我 们 可 以 遵循 的 架构 和 开发 原则 ， 因 为 这 些 是 编写 可 维护 的 代码 的 驱动 力 。 

13. 法 律 法 规 

有 些 行业 受到 当地 法 律 或 监管 机 构 的 严格 管理 , 导致 了 与 数据 保留 或 审计 日 志 等 相关 的 额外 
需求 。 举 个 例子 ， 大 多 数 金 融 机 构 (投资 银行 、 零 售 银行 、 信 托 公司 等 ) 为 了 保持 在 市 场 中 的 运 
作 能 力 ， 必 须 遵 守 一 些 规则 ( 如 反 洗 钱 )。 

14. 国际 化 (i18n) 

很 多 软件 系统 ,特别 是 部 署 在 互联 网 上 的 , 不 再 以 单一 的 语言 交付 。 国际 化 是 指 以 多 种 语言 
交付 软件 中 用 户 可 见 元 素 的 能 力 。 这 看 似 简单 ， 当 你 试图 将 其 加 入 已 有 软件 时 , 才 会 意识 到 有 些 
语言 是 从 右 向 左 书写 的 。 

15. 本 地 化 (110n) 


和 国际 化 相关 的 是 本 地 化 ,是 指 以 符合 最 终 用 户 文化 习俗 的 方式 展现 数字 、 货 币 、 日 期 等 内 
容 。 有 时 候 ， 国 际 化 和 本 地 化 也 统称 为 “全 球 化 ”。 


荆 


哪些 对 你 重要 


我 们 可 以 为 自己 的 软件 系统 指定 的 质量 属性 有 很 多 , 但 它们 的 重要 性 不 尽 相同 。 根据 工作 的 
环境 和 构建 的 软件 系统 的 类 型 ， 有些 质量 属性 比 其 他 的 更 为 适用 。 金 融 行 业 中 基于 Web 的 系统 
的 质量 属性 可 能 就 不 同 于 电信 行业 使 用 的 内 部 系统 。 我 建议 学 习 你 的 领域 内 常用 的 质量 属性 , 在 
开始 构建 一 个 新 系统 或 修改 已 有 系统 时 ， 先 关注 这 些 常 用 的 质量 属性 。 


邮 


第 . 纪 . 刀 阐 
处 理 非 功能 需求 


不 管 你 怎么 称呼 它们 , 往往 都 需要 花费 一 些 精 力 , 来 获得 可 应 用 于 所 构建 的 软件 系统 的 非 功 
能 需求 清单 。 

1. 捕捉 

我 从 事 软 件 开 发 超过 15 年 ， 其 中 大 部 分 是 在 为 客户 构建 软件 的 情况 下 做 咨询 工作 。 在 这 段 
时 间 , 客户 明确 给 出 非 功 能 需求 信息 的 次 数 届 指 可 数 。 我 当然 接 到 过 大 量 需 求 规格 书 或 功能 需求 
清单 ， 但 很 少 看 到 其 中 包括 任何 关于 性 能 、 伸 缩 性 、 安 全 性 等 信息 。 面 对 这 种 情况 ， 你 就 得 主动 
出 击 ， 自 己 去 捕捉 它们 。 

挑战 就 在 这 里 。 如 果 你 问 一 个 业务 担保 人 ,他 们 的 系统 想 达 到 哪 种 级 别 的 可 用 性 , 你 可 能 会 
得 到 一 个 类 似 “100%”、“24/7/365” 或 “好 的 ， 全 部 ”等 回答 。 

2. 提炼 

一 旦 你 开始 问 那些 有 关 非 功能 需求 的 环 手 问题 , 或 你 已 经 走运 到 能 收 到 一 些 信息 , 就 可 能 需 
要 提炼 它们 。 

有 为 数 不 多 的 几 次 , 我 接 到 功能 需求 规格 书 中 确实 包含 一 些 非 功 能 需求 的 信息 , 但 通常 都 含 
糊 无 用 。 举 个 例子 ， 我 曾 从 潜在 客户 那里 收 到 过 一 份 125 页 的 文档 ， 详 述 了 对 软件 系统 的 需求 。 
其 中 功能 需求 的 细节 占据 了 文档 的 绝 大 部 分 ， 只 有 最 后 半 页 是 留 给 非 功能 需求 的 。 里 面 说 道 : 
口 性 能 : 系统 必须 要 快 ; 

口 安全 性 : 系统 必须 安全 ; + 可 用 性 : 系统 的 运行 时 间 应 该 达到 100%。 


56 程序 员 必 读 之 软件 架构 


虽然 不 是 很 有 用 , 但 至 少 能 展开 一 些 讨 论 了 。 你 可 以 根据 交流 对 象 变换 问题 ,而 不 是 问 需 要 
多 少 可 用 性 ， 然 后 得 到 一 个 不 可 避免 的 “24/7” 的 答案 。 比 如 下 面 这 些 。 


口 “ 你 能 忍受 的 系统 停机 时 间 是 多 少 ?” 
口 “ 如 果 系 统 核 心 在 朝 九 晚 六 的 正常 工作 时 间 内 出 现 故 障 ， 会 发 生 什 么 ?” 
口 “ 如 果 系 统 核心 在 正常 工作 时 间 以 外 出 现 故 障 ， 会 发 生 什么 ? ” 


你 现在 要 做 的 是 探索 需求 , 搞 清楚 驱动 力 是 什么 。 为 什么 系统 要 可 见 ? 当 我 们 谈论 “高 安全 
性 ”， 要 保护 的 是 什么 ? 我们 的 目标 是 获得 一 组 特定 的 ， 理 论 上 可 以 明确 量化 的 非 功能 需求 。 比 
如 下 面 这 些 。 


口 系统 平均 应 该 支持 多 少 并 发 用 户 ? 高 峰 时 段 呢 ? 
口 多 长 的 响应 时 间 是 可 以 接受 的 ? 系统 各 个 部 分 都 是 如 此 ， 还 是 只 是 针对 特定 的 功能 ? 
口 为 了 保护 系统 安全 , 我 们 究竟 该 怎么 做 ? 我 们 真 的 需要 对 数据 加 密 吗 , 受 限 访问 足够 了 吗 ? 


如 果 你 能 联想 到 一 定数 量 的 非 功能 性 需求 (如 用 户 数 、 数 据 量 、 最 大 响应 时 间 等 )， 就 能 写 
一 些 验收 标准 并 客观 地 进行 测试 。 


挑战 

记 住 这 一 点 ， 如 果 问 人 们 是 否 需要 一 个 东西 ， 无 疑 我 们 都 知道 他 们 会 说 “是 的 "。 这 就 是 为 
什么 很 难 划 分 功能 需求 .用户 故事 等 的 优先 级 ,不 管 你 使 用 哪 一 种 度量 优先 级 的 方法 ( MoSCoW ， 
高 /中 / 低 , 等 等 )， 只 要 尝试 划分 优先 级 ,每 件 事 最 后 都 会 变 成 “不 可 或 缺 ”。 你 可 以 创建 一 个 “一 
定 不 能 少 ”的 目录 ， 但 我 们 知道 每 件 事 都 会 上 目录 。 


这 就 要 换 一 种 方法 ， 提 出 成 本 的 影响 有 助 于 集中 注意 力 。 比 如 下 面 这 些 。 


口 架构 师 :“ 你 需要 一 个 正常 运行 时 间 为 100% 的 系统 。 构 建 这 个 系统 必须 通过 大 量 元 余 来 
消除 每 一 个 故障 点 ,我 们 所 有 的 花费 都 需要 翻 一 番 ， 外 加 很 多 自动 故障 转移 工程 的 工作 。 
这 个 成 本 大 概 是 100 万 美元 。 或 者 我 们 可 以 为 你 构建 一 个 简单 一 些 的 系统 ， 必 须 告诫 你 ， 
某 些 组 件 可 能 需要 进行 监测 ， 发 生 故 障 时 需要 手动 重启 ， 这 样 的 成 本 大 概 是 10 万 美元 。 
您 需要 哪 一 种 呢 ?” 

口 担保 人 :“ 哦 ， 如 果 是 那样 ， 我 要 便宜 的 方案 。 


几 事 丝 有 可 能 ,但 每 件 事 都 有 代价 。 解 释 那 些 代价 有 助 于 找到 给 定语 境 中 的 最 好 方案 。 


QD https://en.wikipedia.org/wiki/MoSCoW_Method 


第 少子 章 
约 束 


作为 软件 开发 者 , 我 们 创建 的 每 一 件 东西 都 存在 于 现实 世界 中 ， 而 现实 世界 就 有 约束 。 像 质 
量 属性 一 样 , 约束 可 以 驱动 、 塑 造 和 影响 软件 系统 的 架构 。 任 职 的 组 织 或 是 工作 的 环境 ， 都 会 将 
约束 强加 于 你 。 约 束 的 形态 和 大 小 不 尽 相同 。 


时 间 和 预算 的 约束 
时 间 和 预算 可 能 是 大 多 数 软 件 开发 者 都 熟悉 的 约束 ， 因 为 这 两 者 常常 都 不 够 。 


技术 约束 
构建 软件 的 时 候 ， 我 们 经 常 碰 到 一 些 技术 相关 的 约束 ， 特 别 是 在 大 型 组 织 里 。 


口 批准 的 技术 清单 : 许多 大 型 组 织 都 有 一 个 允许 用 于 构建 软件 系统 的 技术 清单 ， 目 的 是 限 
制 组 织 必 须 支 持 ， 运 行 ， 维 护 和 购买 许可 证 的 技术 。 如 果 你 想 使 用 任何 不 在 清单 上 的 技 
术 ， 通常 有 一 个 漫长 的 例外 流程 ,需要 提出 正式 的 申请 。 然 而 ， 我 仍 看 到 有 团队 为 了 能 
在 Java 项 目 中 使 用 Groovy 或 者 Scala 而 偷偷 引入 额外 的 JAR 文件 ! 

口 现 有 系统 的 互 操作 性 : 在 大 多 数组 织 中 ， 你 的 软件 需要 整合 已 有 的 系统 ， 而 实现 整合 的 
手段 往往 非常 有 限 。 除 此 之 外 ， 就 是 别 的 系统 需要 和 你 构建 的 系统 整合 。 在 这 些 情 况 下 ， 
你 可 能 会 发 现 ， 组 织 性 的 约束 规定 了 你 可 以 用 于 整合 的 协议 和 技术 。 一 些 我 合作 过 的 投 
资 银行 就 有 他 们 自己 内 部 用 来 在 软件 系统 间 交 换 交 易 信 息 的 XML 结构 。 我 可 不 会 用 “ 简 
洁 ” 和 “ 易 用 ”来 描述 它们 ! 

口 目标 部 署 平台 : 构建 一 个 全 新 的 软件 系统 时 ， 目 标 部 署 平台 通常 是 影响 技术 决策 的 主要 
因素 之 一 。 这 包括 伟人 式 设 备 、 微 软 的 Windows 或 Linux 服务 器 的 可 用 性 ， 以 及 云 。 是 
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的 , 即使 这 个 我 们 称 为 云 的 神奇 的 东西 , 也 有 约束 。 举 个 例子 , 每 个 “平台 即 服务 ”( PaaS ) 
提供 的 都 不 同 ， 对 某 些 东西 ， 比 如 本 地 磁盘 操作 ， 你 的 软件 能 做 什么 ， 不 能 做 什么 ， 大 
多 数 都 有 限制 。 如 果 你 不 明白 这 些 约束 ， 部 署 时 ， 陪 伴 你 的 很 可 能 是 焦虑 的 返工 。 

口 技术 成 熟 度 : 有 些 组 织 乐于 采用 有 风险 的 尖端 技术 ,拥抱 这 种 进步 带 来 的 风险 。 其 他 组 

织 本 质 上 则 保守 得 多 。 

口 开放 源 代 码 : 同样 的 ， 有 些 组 织 仍 然 不 喜欢 使 用 开源 项 目 ， 除 非 它 跟 IBM 或 微软 这 样 的 名 
字 扯 上 关系 。 我 曾经 在 一 个 高 街 银 行 " 的 项 目 中 工作 , 该 银行 拒绝 使 用 开源 项 目 ， 却 乐于 使 
用 来 自 一 个 非常 著名 的 技术 品牌 的 Web 服务 器 。 那 是 伪装 过 的 开源 Apache Web 服务 器 。 这 
样 的 组 织 在 遇 到 问题 的 时 候 就 喜欢 冲 人 大 喊 大 叫 。 开 源 许可 证 的 混乱 也 阻碍 了 一 些 组 织 完 
全 采用 开源 项 目 。 如 果 你 曾 试图 解释 GPL 和 LGPL 的 区 别 ， 可 能 已 经 目睹 过 这 种 情况 。 

口 供应 商 “ 关 系 ”: 就 像 生活 中 的 很 多 事情 ， 不 是 你 知道 什么 ， 而 是 你 认识 谁 。 很 多 合作 
关系 仍然 是 供应 商 请 CTO (ChiefTechnology Officer， 首 席 技 术 官 ) 吃喝 玩乐 ， 在 高 尔 夫 
球场 上 “达成 ”的 。 如 果 你 曾 为 大 型 组 织 工 作 ， 也 好 奇 为 什么 你 的 团队 被 迫使 用 一 些 明 
显 不 合格 的 东西 ， 原 因 可 能 就 是 这 个 ! 

口 过 去 的 失败 : 2000 年 前 后 ,我 带 着 用 JavaRML ”一 种 允许 通过 Java 虚拟 机 进行 远程 方 
法 调用 的 技术 一 一 构建 解决 方案 的 提案 走 进 一 家 银行 。 我 遇 到 了 很 大 的 阻力 ， 因 为 这 家 
银行 已 经 “尝试 过 它 ,不 管用 ”。 那 个 设计 到 此 为 止 ， 任 何 讨论 都 没 能 改变 他 们 的 主意 。 
由 于 过 去 的 失败 ，Java RMI 在 这 样 的 环境 下 被 封杀 。 最 终 我 们 转 而 构建 了 一 个 框架 ， 通 
过 HTTP 将 序列 化 的 Java 对 象 传 给 一 群 Java Servlets ( 变相 重新 发 明 轮 子 )。 

口 内 部 知识 产权 : 当 你 需要 找到 一 个 库 或 框架 来 解决 所 面临 的 问题 ， 很 可 能 已 经 有 符合 你 
需要 的 开源 或 商业 产品 。 然 而 对 有 些 人 来 说 这 还 不 够 好 ， 你 必须 使 用 组 织 自己 内 部 的 日 
志 库 、 持 和 久 化 框架 或 通信 基础 设施 服务 。 这 种 情况 并 不 罕见 ， 不 管 它们 是 否 真能 正常 工 
作 。 最 近 我 听 说 一 个 组 织 构建 了 自己 的 CORBA ”实现 。 


更 常见 的 是 ， 开 发 软件 可 用 的 技术 和 方法 受 限 于 你 周围 的 人 。 比 如 下 面 这 些 。 


口 你 的 开发 团队 有 多 大 ? 

口 他 们 有 什么 技能 ? 

口 如 果 你 的 开发 团队 需要 扩展 的 话 ， 能 有 多 快 ? 

口 如 果 需 要 的 话 ， 你 能 够 提供 培训 、 咨 询 和 专家 吗 ? 


一般 而 言 ， 各 大 城市 都 有 一 条 或 者 数 条 商业 大 街 ( high street )， 街 上 遍布 各 种 银行 、 商 店 、 邮 局 、 警 察 局 、 超 市 、 
快餐 店 等 。 在 英国 ， 位 于 这 类 街 上 的 银行 被 称 为 “高 街 银 行 ”( high street bank )， 主 要 是 提供 便民 服务 ， 也 称 为 
“零售 银行 "。 因 此 这 类 银行 允许 的 贷款 额度 就 比较 小 。 译 者 注 

@ Common Object Request Broker Architecture， 通 用 对 象 请 求 代理 架构 ， 是 由 OMG ( Object Management Group ， 对 
象 管理 组 织 ) 定义 的 标准 ， 旨 在 促进 部 署 于 不 同 平台 的 系统 间 通 信 。 译 者 注 
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口 如 果 在 交付 后 转交 你 的 软件 ， 接 手 的 维护 团队 拥有 和 你 的 开发 团队 相同 的 技能 吗 ? 


如 果 你 让 一 个 Java 团队 构建 一 个 微软 .NET 解决 方案 ， 相 当 于 给 他 们 当头 一 棒 。 因 此 ， 当 你 
架构 一 个 软件 系统 时 ， 也 要 把 人 考虑 进来 。 


组 织 约束 
你 要 知道 ， 有 时 候 还 有 其 他 约束 ， 包 括 下 面 这 两 个 。 


口 软件 系统 是 战术 或 战略 实施 的 一 部 分 吗 ? 这 个 问题 的 答案 会 影响 约束 的 增 减 。 
口 组 织 政治 有 时 能 阻碍 你 实现 真正 想 要 的 解决 方案 。 


约束 都 是 不 好 的 吗 


被 强加 的 约束 通常 是 “ 坏 ” 的 , 但 往往 是 出 于 好 的 理由 。 比 如 ， 大 型 组 织 不 愿意 支持 和 维护 
天 底下 所 有 技术 ， 就 试图 限制 最 终 用 于 生产 的 技术 。 一 方面 ， 这 会 降低 创造 力 ; 但 男 一 方面 , 它 
也 剔除 了 你 可 能 面 对 的 大 量 洪 在 选项 。 软 件 架构 也 事 关 引入 约束 , 在 一 个 代码 库 里 面 你 到 底 想 要 
多 少 个 日 志 库 或 持久 化 库 ? 


约束 可 以 划分 优先 级 


最 后 一 点 , 值得 记 住 的 是 , 约束 可 以 划分 优先 级 。 就 像 功能 需求 , 有 些 约束 比 其 他 的 更 重要 ， 
利用 好 这 一 点 。 我 在 培训 中 用 作案 例 学 习 的 金融 风险 系统 就 是 基于 我 为 伦敦 的 一 个 咨询 公司 工作 
期 间 的 真实 项 目 。 一 个 投资 银行 找到 我 们 ， 说 他 们 需要 一 个 金融 风险 系统 ， 背 后 的 基本 前 提 是 ， 
由 于 监管 原因 ， 银 行 需 要 有 一 个 风险 系统 才能 进入 一 个 新 的 细 分 市 场 。 


经 过 几 次 售 前 会 议和 专题 研讨 ,对 于 他 们 的 需求 以 及 在 工作 中 需要 面 对 的 约束 , 我 们 有 了 一 
比较 好 的 想法 。 主 要 的 约束 之 一 是 包括 典型 的 重量 级 Java EE 栈 在 内 的 批准 的 技术 清单 ， 另 一 
是 严格 的 时 间 约 束 。 

在 准备 财务 提案 时 ， 我们 大 致 说 了 这 样 的 话 , “是 的 ,我 们 有 信心 在 最 后 期 限 前 交付 系统 ， 
但 为 了 加 快 项 目 ， 我们 要 使 用 一 些 不 在 你 们 的 批准 技术 清单 上 的 技术 ”。 我 们 的 提案 被 接受 了 。 
在 这 种 情况 下 ,时 间 约 束 被 看 作 比 只 使 用 批准 技术 清单 上 的 技术 重要 得 多 , 实际 上 , 我们 会 划分 
约束 的 优先 级 。 约 束 通常 是 你 需要 绕 过 的 障碍 ， 但 有 时 候 也 能 相互 权衡 。 


倾听 约束 


每 一 个 软件 系统 都 要 届 从 于 一 个 或 多 个 约束 , 软件 架构 角色 的 一 部 分 就 是 找 出 这 些 约束 , 搞 
清楚 它们 为 什么 会 被 强加 进来 ， 让 它们 帮助 你 塑造 软件 架构 。 做 不 好 这 件 事 ， 搞 不 好 会 出 大 事 。 


全 全 


约束 是 强加 于 你 的 ， 而 原则 是 你 为 了 将 标准 方法 和 一 致 性 引入 构建 软件 的 方式 而 想 采用 的 。 
通用 的 原则 很 多 ， 有 些 跟 开发 相关 ， 其 他 则 跟 架 构 相 关 。 


开发 原则 
说 到 原则 ， 很 多 软件 开发 者 立刻 想到 的 都 是 关于 软件 应 该 如 何 开 发 。 比 如 下 面 这 些 。 


口 编码 标准 和 规范 :“ 我 们 将 采用 内 部 的 [JavalC# 其 他 ] 语 言 编码 规范 ， 这 可 以 在 我 们 公司 
wiki 找到 。” 

口 自动 化 单元 测试 :“ 我 们 的 目标 是 核心 库 的 自动 化 单元 测试 达到 80% 的 代码 覆盖 率 , 无 论 
代码 开发 是 先 测试 还 是 后 测试 。” 

口 静态 分 析 工 具 :“ 所 有 的 生产 和 测试 代码 在 提交 到 源 代码 管理 之 前 ， 必 须 通 过 
[CheckstylelFxCop| 其 他 ] 定 义 的 规则 。” 


大 和 大生 


口 等 等 。 


架构 原则 
还 有 一 些 原则 是 关于 软件 结构 应 该 如 何 安 排 的 。 比 如 下 面 这 些 。 


层 策略 : 因为 每 一 层 都 独立 于 周围 ,分 层 架 构 通 常 出 现在 有 高 度 灵 活性 的 软件 系统 中 。 
比如 ， 你 可 以 把 软件 系统 解构 为 UI (User Interface， 用 户 界面 ) 层 ， 业 务 层 和 数据 访问 
层 。 使 业务 层 完 全 独立 于 数据 访问 层 意味 着 (通常 ) 可 以 实现 在 不 影响 业务 或 UI 层 的 情 
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况 下 切换 数据 访问 。 能 这 样 做 是 因为 数据 访问 层 向 业务 层 呈 现 了 抽象 ， 而 不 是 业务 层 自 
己 直接 处 理 数 据 存储 机 制 。 如 果 想 以 这 种 方式 安排 软件 结构 ， 你 就 应 当 确 保 开 发 团队 里 
每 个 人 都 明白 这 个 原则 。“UI 组 件 或 域 对 象 里 没有 数据 访问 逻辑 ” 是 该 原则 在 实践 中 的 一 
个 具体 例子 。 

口 业务 逻辑 的 位 置 : 有 时 候 ， 出 于 性 能 或 可 维护 性 的 原因 ， 你 要 确保 业务 逻辑 总 是 驻 留 在 
一 个 地 方 。 对 于 连接 互联 网 的 移动 应 用 程序 ， 你 可 能 想 要 确保 服务 絮 尽 可 能 多 地 处 理发 
生 的 请 求 。 或 者 如 果 你 在 整合 一 个 已 经 包含 了 大 量 业 务 逻 辑 的 遗留 后 端 系统 ， 可 能 想 要 
确保 团队 里 没有 人 打算 复制 它 。 

口 高 内 聚 、 低 耦合 、SOLID 等 : 有 很 多 关注 点 分 离 相关 的 原则 ， 专 注 于 构建 不 需要 太 多 依 

赖 就 能 完成 工作 的 高 内 聚 的 小 结构 单元 。 

口 无 状态 组 件 : 如 果 你 在 构建 一 个 需要 很 强 可 伸缩 性 的 软件 ， 那 么 尽 可 能 把 组 件 设计 得 无 
状态 ， 就 是 一 种 确保 可 以 通过 复制 组 件 来 对 系统 进行 横向 扩展 从 而 分 担负 载 的 方式 。 如 
果 这 是 你 的 可 伸缩 性 策略 ， 每 个 人 都 需要 明白 他 们 必须 使 用 相同 的 模式 来 构建 组 件 。 这 
有 助 于 避免 将 来 出 现任 何 讨厌 的 意外 和 可 伸缩 性 瓶颈 。 

口 存储 过 程 : 关系 型 数据 库 的 存储 过 程 就 像 马 麦 桨 ”一 一 你 对 它们 不 是 爱 就 是 恨 。 用 不 用 存 
储 过 程 都 各 有 优 缺 点 ， 但 当 团 队 只 是 选择 一 种 数据 访问 的 方法 并 坚持 ， 我 还 是 倾向 于 存 
储 过 程 。 然 而 ， 每 条 原则 都 有 例外 。 

口 域 模型 : 丰富 与 贫 将 : 有 些 团 队 喜 欢 在 自己 的 代码 中 有 很 丰富 的 域 模 型 ， 构 建 本 质 上 非 
常 面 向 对 象 的 系统 。 另 一 些 则 倾向 于 更 贫 将 的 域 模 型 ， 对 象 只 是 被 粗 粒 度 组 件 和 服务 使 
用 的 数据 结构 。 方 法 的 一 致 性 有 很 长 的 路 要 走 。 

口 HTTP 会 话 的 使 用 : 如 果 你 在 构建 一 个 网 站 ,可 能 想 或 者 不 想 用 HTTP 会 话 来 存储 请 求 间 
的 临时 信息 。 这 通常 取决 于 很 多 事情 ， 包 括 你 的 伸缩 策略 是 什么 ， 会 话 文 持 对 象 到 底 存 
储 在 哪里 ， 服 务 器 出 现 故 障 时 会 发 生 什么 ， 你 是 否 使 用 粘性 会 话 ， 会 话 复制 的 成 本 ， 等 
等 。 再 次 ， 开 发 团队 的 每 个 人 都 应 该 明白 想 要 的 方法 ， 并 坚持 下 去 。 

口 始终 一 致 与 最 终 一 致 : 很 多 团队 都 发 现 ， 他 们 往往 需要 为 满足 复杂 非 功能 需求 做 出 权衡 。 
比如 : 有 些 团 队 用 数据 一 致 性 换取 性 能 或 可 伸缩 性 。 我 们 能 看 到 所 有 的 Facebook 状态 更 
新 ,但 是 否 都 能 立即 看 到 真 的 重要 吗 ? 你 的 语 境 将 决定 立即 或 延迟 的 一 致 性 是 否 妥当 ， 
但 一 致 的 方法 很 重要 。 


谨防 最 佳 实践 


如 果 你 经 常 构建 大 型 企业 软件 系统 ， 可 能 考虑 过 大 多 数 我 刚才 列 出 的 “最 佳 实践 ”原则 。 但 


QD http://en.wikipedia.org/wiki/SOLID (object-oriented_design) 
@@) http:/en.wikipedia.org/wiki/Marmite， 一 种 黏稠 状 、 深 棕色 并 且 有 人 鲜明 特色 风味 的 桨 , 通常 抹 在 面包 等 食品 上 食用 。 
译 者 注 


@ http://facebook.com/， 著 名 社交 网 站 。 一 一 译 者 注 
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要 小 心 。 即 使 是 最 善意 的 原则 ， 有 时 候 也 会 产生 意 想不到 的 负面 影响 。 如 果 只 是 构建 一 个 快速 的 
战术 方案 ， 为 确保 完整 的 关注 点 分 离 而 采用 复杂 的 分 层 策略 ， 也 能 耗费 你 大 量 时 间 。 原 则 通常 是 
因为 好 的 理由 才 引 入 ， 但 它们 并 不 是 任何 时 候 都 有 好 处 。 

构建 软件 的 大 小 和 复杂 度 , 加 上 环境 的 约束 ,会 帮助 你 决定 采用 哪些 原则 。 语 境 一 如 既往 是 


关键 。 一 份 明确 的 原则 清单 有 助 于 确保 团队 中 每 个 人 都 以 相同 的 方式 工作 , 但 你 要 确保 这 些 原 则 
是 帮助 而 非 阻碍 。 倾 听 团 队 成 员 的 反馈 会 帮助 你 认 清 你 的 原则 是 否 奏效 。 


第 少 O 章 
技术 不 是 买 现 细节 


我 举办 的 培训 班 经 常 要 求学 员 分 成 小 组 设计 一 个 简单 的 金融 风险 系统 。 当 问 起 为 什么 他 们 的 

图 表 不 包含 任何 技术 决策 ， 我 会 听 到 下 面 这 些 常 见 的 回答 。 
口 “[ 风 险 系统 ] 解 决 方案 很 简单 ， 可 以 用 任何 技术 构建 。” 
口 “ 我 们 不 想 强 迫 开发 者 使 用 一 种 解决 方案 。” 

口 “ 那 是 实现 细节 。” 
口 “ 我 们 遵循 “最 后 责任 时 刻 ” 原 则 。” 

我 坚信 ， 架 构图 应 该 包括 技术 的 选择 , 但 这 里 有 男 外 一 个 问题 ,为 什么 人 们 不 乐意 做 技术 决 
策 。 说 “ 它 可 以 用 任何 技术 构建 ”并 不 意味 着 应 该 如 此 。 原 因 如 下 。 

1. 你 有 复杂 的 非 功能 需求 吗 

确实 ， 大 多 数 软件 系统 都 可 以 用 几乎 任何 技术 构建 ，Java、.NET、Ruby、Python 、PHP， 等 
等 。 看 看 大 多 数 软件 系统 的 数据 存储 需求 ， 也 会 发 现 几 乎 所 有 的 关系 型 数据 库 都 能 完成 任务 。 大 
多 数 软 件 系 统 在 非 功能 特性 方面 的 要 求 都 不 高 ， 因 此 任何 主流 技术 都 差不多 能 满足 。 

但 是 ,如 果 你 有 复杂 的 非 功能 需求 ， 比 如 高 性 能 或 可 伸缩 性 , 那 会 怎样 ”事情 很 可 能 开始 变 
得 棘手 ， 你 必须 搞 清 楚 你 的 技术 ( 和 架构 ) 选择 是 否 会 管用 。 如 果 你 不 考虑 非 功 能 需求 ， 你 的 软 
件 系统 就 可 能 无 法 满足 目标 。 

2. 你 有 约束 吗 

对 于 构建 软件 可 采用 的 技术 和 的 可 选 的 技能 ( 人 )， 很 多 组 织 都 有 约束 。 有 些 甚 至 断定 软件 
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应 该 购买 或 定制 ， 而 非 自 己 构建 。 约 束 能 ( 且 会 ) 影响 你 能 给 出 的 软件 架构 。 可 以 用 各 种 手段 挑 
战 约 束 ， 但 不 能 忽视 ， 否 则 就 会 有 交付 一 个 无 法 与 组 织 已 有 的 IT 环境 集成 的 软件 系统 的 风险 。 


3. 你 有 一 致 性 吗 


想象 你 在 构建 一 个 把 数据 存储 到 关系 型 数据 库 的 软件 系统 。 在 实现 功能 时 , 开发 者 个 人 如 何 
从 数据 库 检索 数据 和 向 其 存 人 数据 重要 吗 ? 我 见 过 一 个 Java 系统 ， 同 一 个 代码 库 中 采用 了 多 个 
数据 访问 技术 /框架 ; 还 见 过 一 个 SharePoint 系统 ,各 个 组 件 的 配置 方式 不 尽 相 同 。 有 时 候 , 发 生 
这 种 事情 是 因为 代码 库 随 着 时 间 演 变 , 方法 也 在 变化 , 但 通常 只 是 开发 团队 每 个 人 完全 自由 选择 
自己 最 熟悉 的 任何 技术 /框架 /方法 带 来 的 副作用 。 


人 们 经 常 问 我 “选择 哪个 日 志 框架 是 否 真 的 很 重要 ”， 如 果 你 想 让 开发 团队 里 每 个 人 都 使 用 
同一 个 日 志 框 架 , 那么 是 很 重要 。 有 些 人 乐意 允许 开发 团队 里 任何 人 下 载 和 使 用 任何 他 们 想 要 的 
开源 库 。 另 一 些 则 意识 到 如 果 不 加 以 检查 ,就 会 导致 问题 。 我 不 是 说 要 扼杀 创新 , 但 你 的 代码 库 
真 的 应 该 只 有 一 个 日 志 、 依 赖 注入 或 对 象 关 系 映射 框架 。 


缺乏 一 致 性 的 方法 会 导致 代码 库 难以 理解 、 维 护 和 增强 。 增 加 单独 可 移动 部 件 的 数量 也 会 让 


2 
部 署 、 运 营 和 支持 变 得 复杂 。 


推迟 与 解 耦 


有 必要 简单 谈 谈 推迟 技术 决策 和 等 到 “最 后 责任 时 刻 ” 才 做 出 决策 。 让 我 们 想象 一 下 ,你 在 
设计 一 个 没有 任何 特别 繁重 的 非 功 能 需求 或 约束 的 软件 系统 ,你 选择 什么 技术 重要 吗 ? 一 个 好 的 
架构 难道 不 应 该 容许 你 日 后 改变 主意 吗 ? 


举 个 例子 , 很 多 人 会 说 , 你 用 哪个 关系 型 数据 库 真 的 不 重要 ,特别 是 如 果 你 用 一 个 对 象 关系 
映射 层 将 代码 与 特定 的 数据 库 实现 解 厢 ， 比 如 Hibernate 、Entity Framework 或 者 ActiveRecord。 
如 果 你 没有 任何 重要 的 非 功 能 需求 或 约束 , 并 且 确 实 认 为 所 有 的 关系 型 数据 库 都 是 相等 的 , 那么 
你 用 哪 一 个 可 能 不 重要 。 是 的 ， 你 可 以 在 代码 中 解 耦 数据库 ， 推 迟 技术 决策 。 但 是 别 忘 了 ， 当 数 
据 库 的 选择 不 再 是 重要 决策 ，ORM 的 选择 就 是 了 。 你 可 以 通过 引入 男 一 个 抽象 层 ， 在 代码 中 解 
而 ORM， 但 这 里 又 做 了 一 个 软件 系统 结构 的 重要 决策 。 


解 而 是 很 好 的 方法 ,原因 很 多 ,而 且 它 使 技术 决策 得 以 推迟 。 当 然 , 这 并 不 意味 着 你 应 该 推 
迟 决 策 ， 特 别 是 由 于 非 功 能 需求 和 约束 的 存在 相关 的 原因 。 


st 


每 个 决策 都 是 权衡 
这 又 回 到 一 个 事实 ， 任 何 技术 都 有 其 优 缺 点 ， 作 为 可 交换 的 商品 ， 并 不 一 定 有 不 同 的 选项 。 


对 于 通常 被 看 作 是 商业 化 的 技术 ， 关 系 型 数据 库 和 Web 应 用 程序 框架 是 两 个 典型 的 例子 。 很 多 
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云 服 务 提供 商 也 是 如 此 ， 即 使 他 们 有 各 自 关于 部 署 、 监 测 、 管 理 、 成 本 、 持 续 磁盘 访问 等 方面 的 
权衡 。 

一 天 结束 时 ,不 论 是 否 与 性 能 、 可 伸缩 性 、 可 维护 性 、 找 到 有 合适 经 验 的 人 的 能 力 等 方面 相 
关 , 你 做 出 的 每 一 个 技术 决策 都 有 权衡 。 理 解 技术 选择 也 能 协助 高 层次 的 预测 和 计划 ， 如 果 你 需 
要 明日 是 否 能 用 给 定 的 有 限 预 算 实现 目标 ， 这 就 很 有 用 。 


如 果 你 不 明白 选择 XX 技 术 而 非 Y 的 权衡 , 那 就 不 应 该 做 决策 。 设计 软件 系统 的 人 要 懂 技 术 ， 
这 很 重要 。 这 就 是 为 什么 软件 架构 师 应 该 是 建造 大 师 。 

技术 不 只 是 一 个 “实现 细节 ”， 你 做 出 的 技术 决策 跟 你 分 解 、 安 排 和 设计 软件 系统 的 方式 同 
等 重要 。 推 迟 技术 决策 ， 后 果 自 负 。 


第 .包间 
更 多 分 层 等 于 更 高 复杂 度 


我 们 在 培训 课程 中 学 习 的 金融 风险 系统 案例 的 关键 功能 需求 之 一 是 解决 方案 应 该 能 够 分 发 
数据 到 企业 局 域 网 用 户 的 一 个 子 集 。 显然 有 很 多 种 不 同 的 方法 来 解决 这 个 问题 , 其 中 最 简单 的 是 
允许 用 户 通 过 一 个 内 部 的 Web 应 用 程序 访问 数据 。 既 然 只 有 组 织 内 用 户 的 一 个 子 集 应 该 看 到 数 
据 ， 任 何 解决 方案 对 数据 都 需要 某 种 形式 的 认证 和 授权 。 


鉴于 最 近 围 绕 Web 2.0 和 富 互 联网 应 用 的 传言 ， 培 训 班 里 有 一 个 组 认为 允许 通过 微软 
Silverlight 应 用 程序 访问 数据 会 很 不 错 。 他 们 已 经 想 过 构建 一 个 ASPNET 应 用 程序 ， 但 又 喜欢 
Silverlight 提供 的 更 多 可 能 性 ， 比 如 交互 式 地 切割 数据 。 他 们 这 个 决定 的 男 一 个 驱动 因素 是 
Silverlight 客户 端 可 以 “免费 ”提供 , 花费 的 时 间 “ 和 构建 一 个 ASPNET 应 用 程序 是 一 样 的 "。“ 免 
费 ” 是 一 个 非常 大 胆 的 观点 ， 特 别 是 考虑 到 他 们 有 效 地 向 软件 系统 中 添加 了 一 个 额外 的 架构 层 。 
下 面 是 我 画 的 他 们 设计 的 概况 ， 用 以 说 明 增加 的 复杂 度 。 

虽然 我 不 认为 Silverlight 应 用 程序 不 难 构建 ， 然 而 小 组 没有 指出 的 关键 问题 是 数据 从 哪 来 。 
像 往 常 一 样 ， 有 一 些 选 项 ; 从 直接 访问 数据 数据 库 ， 到 在 中 间 层 暴露 一 些 数据 服务 。 


小 组 已 经 考虑 了 在 IIS (Internet Information Services， 互 联网 信息 服务 ) Web 服务 器 上 部 署 
一 些 Windows 通信 和 基础 (WCF，Windows Communication Foundation ) 服务 ， 作 为 数据 暴露 机 制 ， 
但 这 导致 了 更 多 的 问题 。 


(1) 你 需要 向 Silver 客户 端 暴露 什么 操作 ? 

(2) 你 会 使 用 哪些 技术 捆绑 和 协议 ? 

(3) 你 如 何 确保 人 们 不 能 插入 自己 定制 的 WCEF 客户 端 并 消费 服务 ? 
(4) 如 何 部 署 和 测试 ? 

(5) 其 他 。 
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非 功 能 需求 


在 这 个 案例 学 习 中 , 第 三 个 问题 很 重要 。 数 据 只 应 该 被 一 小 部 分 人 访问 ,我 们 确实 不 想 暴露 
一 个 任何 可 以 访问 开发 工具 的 人 都 能 消费 的 Web 服务 。 


大 多 数 安全 意识 很 强 的 组 织 会 在 自己 托管 的 对 外 Web 服务 器 和 隔离 区 之 间 部 署 防火 墙 , 但 我 
也 见 过 一 些 软件 系统 , 同样 是 那些 受 保护 的 Web 服务 器 随后 去 访问 正常 的 企业 局 域 网 内 部 服务 器 
上 部 署 的 未 受 保护 的 Web 服务 。 假 设 我 的 笔记 本 电脑 能 连接 到 企业 局 域 网 , 通常 就 没有 什么 能 阻 
止 我 打开 微软 Visual Studio 之 类 的 开发 工具 ， 定 位 到 服务 定义 ( 比如 一 个 WSDL，Web Services 
Description Language ，Web 服务 描述 语言 文件 )， 以 不 正当 用 途 消费 Web 服务 。 在 这 种 情况 下 ， 必 
须 考 虑 数据 服务 的 认证 和 授权 ，Silverlight 客户 端 也 是 如 此 。 这 需要 对 安全 有 全 面 的 考虑 。 


时 间 和 预算 : 没有 什么 是 免费 的 


回 到 构建 Silverlight 客户 端 不 会 比 构建 ASPNET 应 用 程序 更 花 时 间 的 断言 ， 其 实 这 不 可 能 ， 
因为 需要 开发 额外 的 数据 服务 来 支持 Silverlight 客户 端 。 在 这 种 情况 下 ， 额 外 的 富 客 户 端 层 带 来 
收益 的 同时 , 也 要 考虑 到 额外 引入 的 复杂 度 。 所 有 的 架构 决策 都 少不了 权衡 。 更 多 的 可 移动 部 件 
意味 着 更 多 的 设计 、 开 发 、 测 试 和 部 署 工作 。 不 管 厂商 的 市 场 炒 作 会 怎么 说 ， 从 来 没有 什么 是 免 
费 的 ， 你 需要 评估 给 设计 增加 额外 层 的 优 缺 点 ， 特 别 是 如 果 它 们 产生 了 额外 的 进程 间 通 信 。 
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让 我 们 想象 一 下 ， 你 被 任命 负责 建设 一 个 三 层 的 Web 应 用 程序 ， 有 一 个 由 具备 Web 技术 、 
服务 端 编程 和 数据 库 专 长 的 人 组 成 的 小 团队 。 从 资源 的 角度 来 看 ， 这 堪 称 完美 ， 因 为 你 拥有 跨越 
整个 栈 的 经 验 。 你 不 应 该 有 任何 问题 ， 对 吧 ? 


整个 团队 的 有 效 性 取决 于 很 多 因素 , 其 中 之 一 是 克制 自负 的 情绪 , 专注 于 交付 给 定语 境 下 的 
最 佳 解决 方案 的 意愿 。 有 时 候 ， 个 别人 由 于 缺乏 团队 合作 的 经 验 ， 或 在 工作 中 产生 了 自负 情绪 ， 
都 会 拖 团队 的 后 腿 。 如 果 有 需求 是 为 用 户 查 看 和 处 理 我 们 的 三 层 Web 应 用 程序 上 的 数据 提供 一 
种 方式 ， 每 一 个 专家 可 能 都 会 给 你 不 同 的 方法 。 

口 Web 开发 者 : 只 要 给 我 JSON 格式 的 数据 ， 我 们 就 能 用 它 在 Web 层 做 任何 想 做 的 事 。 甚 
至 能 加 入 一 些 jQuery 来 动态 处 理 浏 览 需 中 的 数据 ; 

口 服务 端 开发 者 : 我 们 应 该 重用 和 扩展 一 些 中 间 服 务 层 已 有 的 业务 逻辑 。 这 增加 了 重用 ， 
比 把 全 部 数据 都 发 到 Web 层 更 安全 ， 还 能 在 周围 编写 自动 化 单元 测试 ; 

口 数据 库 开 发 者 : 你 们 都 是 白痴 。 不管 你 们 要 什么 数据 ,我 都 能 很 快 地 写 一 个 存储 过 程 出 来 。 


经 验 影响 软件 设计 


我 们 拥有 的 知识 、 经验 和 偏好 往往 会 影响 我 们 设计 软件 的 方式 , 尤其 是 如 果 一 个 人 单枪匹马 
完成 。 缺少 了 交流 , 我 们 往往 会 基于 已 有 的 对 软件 应 该 如 何 设计 的 心智 模型 ， 去 假设 组 件 应 该 放 
在 哪里 、 特 性 会 如 何 工作 。 尽 早 扔 掉 这 些 假设 有 助 于 避免 一 些 无 可 挽回 的 糟糕 意外 。 我 倾向 于 使 
用 和 白板 来 设计 软件 的 一 个 主要 原因 是 它 鼓 励 更 加 合作 的 方式 , 而 不 是 大 家 都 对 着 自己 电脑 上 最 喜 
欢 的 建 模 工 具 ， 各 自 为 政 。 合 作 ， 也 就 是 相互 沟通 和 挑战 。 


IO 
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就 像 结 对 编程 ,合作 是 处 理 软件 设计 流程 的 一 个 有 效 途 径 , 特别 是 如 果 用 轻 量 级 的 方法 来 做 。 
合作 提高 了 质量 , 也 让 我 们 可 以 讨论 和 挑战 一 些 常见 的 基于 自己 已 有 知识 、 经 验 和 喜好 做 出 的 假 
设 。 它 也 为 代码 集体 所 有 制 铺 平 了 道路 ， 有 助 于 打破 软件 开发 团队 中 常见 的 孤岛 。 团 队 中 的 每 个 
人 都 会 有 不 同 的 想法 ， 但 要 达成 共识 。 


第 少儿 章 
软件 架构 是 对 话 的 平台 


如 果 写 软件 是 你 日 常 工作 的 一 部 分 ， 那么 你 的 软件 很 可 能 不 会 孤立 存在 。 在 项 目 小 团队 里 ， 
团队 情绪 高 涨 的 时 候 。 我 们 甚至 建立 起 开发 流程 
来 帮助 更 好 地 沟通 , 设 定 优先 级 , 最终 交 付 更 好 的 软件 。 然 而 ,很 多 软件 项 目 仍 然 由 远离 用 户 和 
运行 环境 的 团队 孤立 地 开发 。 


敏捷 方法 的 成 功 告诉 我 们 , 要 定期 与 最 终 用 户 或 他 们 的 代表 沟通 , 才能 确保 我 们 构建 的 软件 


我 们 会 感到 安全 ,特别 是 当 每 个 人 都 相互 认识 、 


但 你 经 常会 


口 


回回 :日 ， 量 : 日 ; 日 


“ 没 人 告诉 我 们 你 需要 在 这 个 服务 器 上 创建 一 个 生产 数据 库 。” 
“我 们 不 能 在 那 台 服务 器 上 升级 到 [Java 7|.NET 4]， 除 非 X 系统 兼容 。” 
“我 们 没有 多 余 的 生成 许可 证 。” 


“对 不 起 ， 这 违反 了 我 们 的 安全 政策 。” 


符合 他 们 的 需要 。 但 其 他 的 利益 相关 者 怎么 办 ? 项 目 团队 对 软件 应 该 做 什么 可 能 有 清晰 的 愿景 ， 


听 到 下 面 这 样 的 说 法 ， 交 付 周 期 总 是 延迟 。 


“对 不 起 ， 在 把 你 的 应 用 程序 推送 到 生产 环境 之 前 ， 我 们 需要 做 一 些 操作 验收 测试 。” 


“我 们 到 底 应 该 怎 


数据 库 凭据 给 你 。” 


lL 支持 该 应 月 


程序 ?” 
“我 不 在 乎 你 是 否 有 一 个 完全 自动 化 的 发 布 流程 


口 “我 们 需要 运行 这 个 才能 通过 风险 和 合 规 团队 。” 
口 “绝对 不 能 让 你 的 系统 运行 在 公有 云 上 。” 


Se 我 不 会 


你 的 配置 文件 所 需 的 生产 
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软件 开发 不 只 是 交付 特性 
软件 的 使 用 者 只 是 利益 相关 者 的 一 类 。 通 常 还 有 很 多 其 他 的 类 型 ， 包 括 下 面 这 些 。 


口 当前 的 开发 团队 : 当前 的 团队 需要 了 解 架构 ， 知 道 驱动 力 是 什么 ,这样 他 们 给 出 的 解决 
方案 才 会 与 架构 一 致 ， 并且“ 管用 ”。 

口 未 来 的 开发 团队 : 任何 未 来 的 开发 、 维 护 团队 都 需要 掌握 相同 的 信息 ， 这 样 他 们 才 会 明 
白 解决 方案 如 何 运作 ， 才 能 以 一 致 的 方式 修改 它 。 

口 其 他 团队 : 你 的 软件 往往 需要 和 环境 中 的 其 他 系统 集成 ， 从 定制 的 软件 系统 到 厂商 的 现 
成 产品 ， 因 此 每 个 人 对 它 如 何 工 作 达 成 共识 是 至 关 重 要 的 。 

口 数据 库 管 理 员 : 有 些 组 织 有 单独 的 数据 库 团 队 ， 他 们 需要 了 解 你 的 解决 方案 如 何 使 用 他 
们 的 数据 库 服务 ( 比如 ， 从 设计 和 优化 到 容量 规划 和 归档 )。 

口 执行 /支持 人 员 : 业务 人 员 通 常 需要 了 解 如 何 运 行 和 支持 你 的 系统 ( 比如 ， 从 配置 和 部 署 
到 监测 和 故障 诊断 )。 

口 遵守 、 风 险 和 审计 : 有 些 组 织 有 必须 遵守 的 严格 规定 ， 你 的 组 织 可 能 也 需要 证 明 你 们 确 
实 遵守 了 这 些 规 定 。 

口 安全 团队 : 对 安全 也 是 如 此 。 有 些 组 织 有 专门 的 安全 团队 ， 系 统 要 经 过 他 们 的 评审 才 允 
许 进入 生产 环境 。 


这 些 只 是 一 部 分 可 能 和 你 的 架构 有 利害 关系 的 利益 相关 者 , 可 能 还 有 其 他 的 , 这 取决 于 你 的 
组 织 及 其 运作 方式 。 如 果 你 认为 自己 能 闭门造车 独立 完成 一 个 软件 架构 ,你 很 可 能 错 了 。 软 件 架 
构 并 非 是 孤立 的 , 软件 设计 过 程 是 一 个 交流 的 平台 。 五 分 钟 的 交流 就 有 助 于 捕捉 那些 往往 不 起 眼 
的 架构 驱动 力 ， 提 高 成 功 交付 的 机 会 。 


心 
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尽管 我 的 商业 经 验 大 多 数 都 跟 开发 定制 的 软件 系统 有 关 , 也 还 是 见 过 不 少 SharePoint 和 其 他 
产品 /平台 实现 ,软件 架构 的 基本 原理 已 被 遗忘 或 忽视 。 这 里 总 结 了 为 什么 软件 架构 对 SharePoint 
项 目 很 重要 。 


1. 很 多 SharePoint 实现 都 不 只 是 SharePoint 


我 见 过 的 很 多 SharePoint 解决 方案 都 不 仅仅 是 最 终 用 户 可 以 创建 列表 、 分 享 文档 和 协作 的 
SharePoint 产品 的 简单 实现 。 与 大 多 数 软 件 系统 一 样 ,它们 是 新 旧 技 术 的 混合 体 , 是 复杂 的 集成 ， 
常常 通过 Web 服务 和 其 他 集成 技术 进入 企业 的 其 他 部 分 。 无 论 是 运行 在 SharePoint 内 部 还 是 外 部 ， 
定制 的 .NET 代码 往 往 也 是 整体 解决 方案 的 一 部 分 。 如 果 你 不 考虑 “大 局 ”、 了 解 环境 及 其 约束 ， 
你 最 终 构建 的 东西 有 可 能 是 错 的 或 者 不 管用 。 


2. 非 功能 性 需求 仍然 适用 于 SharePoint 解决 方案 


即使 你 没有 为 你 的 SharePoint 解决 方案 写 任何 定制 代码 ， 也 不 意味 着 你 能 忽略 非 功 能 需求 。 
性 能 、 可 伸缩 性 、 安 全 性 、 可 用 性 、 灾 难 恢复 、 审 计 、 监 测 等 都 是 潜在 适用 的 。 我 见 过 SharePoint 
项 目 团 队 忽 视 对 关键 非 功 能 性 需求 的 考虑 ,甚至 是 面向 互联 网 的 公开 网 站 。 结果 不 出 所 料 , 一 个 
响应 时 间 糟 糕 或 安全 缺陷 严重 ( 如 跨 站 点 脚本 ) 的 解决 方案 。 这 样 的 问题 在 项 目 生 命 周期 的 后 期 
才 被 发 现 。 


荐 
| 


Q 微软 开发 的 企业 信息 管理 方案 。 一 一 译 者 注 
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3. SharePoint 项 目 很 复杂 ， 也 需要 技术 领导 


和 其 他 编程 语言 一 样 , SharePoint 是 一 个 复杂 的 平台 , 解决 一 个 问题 通常 有 很 多 不 同 的 方式 。 
为 了 得 到 保持 方法 的 一 致 性 ， 避 免 混 乱 ，SharePoint 项 目 很 强 的 技术 领导 力 。 无 论 你 是 实现 一 个 
平台 还 是 从 无 到 有 编写 软件 系统 ， 软 件 架构 角色 都 适用 。 如 果 你 见 过 这 样 的 SharePoint 项 目 , 一 
个 看 起 来 很 混乱 的 团队 最 终 交 付 质量 糟糕 的 解决 方案 ， 你 就 会 明白 为 什么 有 技术 领导 力 很 重要 。 


4. SharePoint 解决 方案 仍然 需要 编写 文档 


有 了 这 样 的 复杂 度 ， 我 还 惊讶 地 不 断 看 到 没有 任何 文档 的 SharePoint 解决 方案 。 我 不 是 在 说 
多 达 200 页 的 文件 , 但 至 少 应 该 有 一 些 轻 量 级 的 文档 , 给 出 解决 方案 的 概览 。 用 一 些 图 表 来 展示 
SharePoint 解决 方案 如 何在 高 层次 工作 ， 也 很 有 用 。 我 的 C4 方法 也 很 适合 SharePoint, 一 些 轻 量 
级 的 文档 可 以 成 为 未 来 的 支持 、 维 护 和 改进 工作 的 一 个 很 好 的 出 发 点 , 特别 是 如 果 项 目 团队 有 变 
化 , 或 者 如 果 项 目 在 外 包 协 议 下 交付 。 


强大 的 领导 力 和 纪律 不 只 是 针对 软件 开发 项 目 


如 果 要 交付 软件 解决 方案 ， 那 就 需要 确保 至 少 有 一 个 人 担任 技术 领导 角色 ， 否 则 你 就 错 了 。 
另 一 方面 , 所 有 这 些 都 适用 于 其 他 平台 的 产品 ， 比 如 SAP 和 微软 Dynamics CRM, 特别 是 如 果 你 
“只 是 增加 一 个 面向 互联 网 的 ASPNET 网 站 ， 来 通过 互联 网 暴露 一 些 数据 ”。 


我 曾 向 SharePoint 团队 提起 这 一 点 ， 有 的 回答 :“ 但 是 SharePoint 不 是 软件 开发 。” 无 论 是 不 
是 软件 开发 ， 成 功 的 SharePoint 项 目 需 要 很 强 的 技术 领导 力 和 纪律 。SharePoint 项 目 也 需要 软件 
架构 。 


第 .PY 章 


问 卉 


(1) 影响 软件 系统 最 终 架 构 的 主要 因素 是 什么 ?你 能 列 出 哪些 跟 你 工作 中 的 软件 系统 有 关 的 
因素 ? 

(2) 什么 是 非 功 能 性 需求 ， 它 为 什么 重要 ?什么 时 候 应 该 考虑 非 功能 需求 ? 

(3) 时 间 和 预算 是 大 多 数 人 立刻 联想 到 的 约束 ， 你 能 指出 更 多 吗 ? 

(4) 你 的 软件 开发 团队 是 否 使 用 了 知名 的 架构 原则 ? 哪些 原则 ? 团队 每 个 人 都 清楚 地 理解 这 
些 吗 ? 

(5) 你 如 何 处 理 软件 设计 流程 ? 你 的 团队 是 以 同样 方式 处 理 的 吗 ?” 它 可 以 明确 阐述 吗 ? 你 能 
帮助 别人 遵从 同样 的 方式 吗 ? 


这 部 分 是 关于 用 一 套 轻 量 但 有 效 的 草图 对 软件 


将 


第 .风纪 章 


沟通 降 但 


如 果 你 正在 一 个 敏捷 软件 开发 团队 中 工作 , 那 就 看 看 周围 。 不 管 是 真实 还 是 虚拟 的 ， 可 能 都 
有 一 个 故事 增 或 看 板 ， 可 视 化 了 将 要 开始 的 、 进 行 中 的 和 已 完成 的 工作 。 


为 什么 ? 简单 来 说 , 可 视 化 软件 开发 流程 是 一 个 引入 透明 的 奇妙 方式 , 因为 任何 人 都 能 从 一 
个 较 高 层次 一 眼看 清 当 前 的 进度 。 将 它 与 价值 流程 图 "之 类 的 技术 结合 起 来 ， 就 可 以 开始 设计 一 
些 复杂 看 板 来 体现 团队 的 工作 方式 。 我 们 这 个 行业 已 经 变 得 非常 善于 可 视 化 软件 开发 流程 。 

然而 , 我 们 似乎 已 经 忘 了 如 何 对 正在 构架 的 软件 进行 可 视 化 。 我 指 的 不 仅 是 项 目 完成 后 的 文 
档 ， 还 包括 软件 开发 过 程 中 的 沟通 。 


里 解 软件 架构 并 不 等 于 能 够 表达 它 。 你 办 公 室 墙 上 的 那些 架构 图 ,是 反映 了 正在 构建 的 系统 ， 
还 是 跟 代 码 结构 没有 任何 相似 之 处 的 概念 抽象 而 已 。 多 年 来 , 我 举办 的 架构 培训 班 已 有 上 千 人 参 
与 , 我 可 以 非常 自信 地 说 , 可 视 化 一 个 软件 系统 的 架构 是 一 种 只 有 极 少 人 具备 的 技能 。 很 多 人 都 
可 以 画图 , 但 那些 图 往往 有 太 多 的 想象 空间 , 也 几乎 没有 人 使 用 正规 的 图 表 符 号 来 描述 他 们 的 解 
决 方案 ,这 跟 我 十 年 前 和 软件 团队 工作 的 经 验 形成 鲜明 对 比 。 


抛弃 UML 


回想 一 下 , 结构 化 流程 给 软件 设计 流程 和 表达 最 终 设计 都 提供 了 参考 点 。 广为人知 的 例子 包 
括 Rational 统一 过 程 (RUP ) 和 结构 化 系统 分 析 与 设计 方法 (SSADM )。 软 件 开 发 行业 在 很 多 方 
面 已 经 发 生 改变 ， 但 我 们 似乎 忘 了 这 些 老 方法 留 给 我 们 的 一 些 好 东西 。 


作为 一 个 行业 ， 我 们 有 统一 建 模 语言 (UML )， 一 种 用 来 表达 软件 系统 设计 的 正规 的 标准 化 


GD http://en.wikipedia.org/wiki/Value_stream mapping 
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符号 。 然 而 ， 就 UML 对 软件 设计 沟通 是 否 有 效 的 辩驳 ， 通 常 是 无 关 紧 要 的 ， 因 为 很 多 团队 已 经 
不 再 使 用 UML, 甚至 根本 不 知道 它 是 什么 。 这 样 的 团队 通常 会 画 些 不 正规 的 框 线 草图 , 但 是 这 些 
图 往往 没有 太 大 意义 ,除非 青 劳 神 费力 加 上 详尽 的 叙述 。 下 回 再 有 人 围绕 那些 不 正规 的 草图 给 你 
展示 软件 设计 时 , 你 就 问 问 你 自己 , 他 们 展示 的 东西 到 底 是 在 草图 上 的 , 还 是 在 他 们 的 脑子 里 的 。 


框 线 草 图 可 以 工作 得 很 好 ,但 也 会 为 软件 架构 的 沟通 带 来 很 多 隐患 


抛弃 UML 没什么 问题 ,但 在 敏捷 比赛 中 ， 很 多 软件 开发 团队 都 失去 了 视觉 化 的 沟通 能 力 。 
上 图 是 软件 架构 草图 的 例子 ， 说 明了 一 些 软件 架构 沟通 的 典型 方法 ， 都 存在 如 下 问题 : 


口 颜色 标注 通常 意 义 不 明 或 不 统一 ; 

口 图 表 元 素 〈 比如， 不 同样 式 的 框 和 线 ) 的 作用 不 明 ; 
口 图 表 元 素 之 间 的 重要 关系 有 时 是 缺失 或 含混 的 ; 

口 频繁 使 用 如 “业务 逻辑 ”之 类 的 术语 ; 

口 技术 选择 (或 可 选项 ) 通常 被 忽略 了 ; 

口 抽象 层次 混乱 ; 

口 图 表 常 常 包含 过 多 的 细 市 ; 

口 图 表 常 常 缺少 语 境 或 逻辑 起 点 。 


框 线 草图 可 以 工作 得 很 好 , 但 也 会 为 软件 架构 的 沟通 带 来 很 多 隐患 。 我 的 方法 是 用 一 套 简单 
图 表 ， 各自 只 展示 整个 故事 的 一 部 分 ,不 使 用 UML 时 要 密切 关注 图 表 元 素 。 
敏捷 需要 良好 的 沟通 


为 什么 这 很 重要 ? 身 处 敏捷 交付 和 精益 创业 的 今天 ,很 多 软件 团队 都 失去 了 对 正在 构建 的 东西 
的 沟通 能 力 。 这 些 团队 常 常 缺 少 技术 领导 力 、 方 向 和 一 致 性 , 也 就 不 足 为 奇 了 。 要 确保 每 个 人 都 在 
为 相同 的 目标 付出 ， 就 要 有 效 地 表达 你 正在 构建 的 东西 是 什么 样 的 。 想 要 人 敏捷， 就 要 高 效 地 表达 。 


第 .了 .了 章 
对 草图 的 需要 


当 告 诉 人 们 我 到 世界 各 地 去 教 人 软件 架构 和 如 何 绘图 时 , 得 到 的 反应 通常 是 怀疑 或 取笑 。 平 
心 而 论 ， 不 难看 出 这 是 为 什么 。 软 件 架构 的 名 声 已 经 很 差 了 ,一 说 “大 局 ”往往 会 让 人 想起 分 析 
瘫痪 和 一 堆 很 少 有 人 真正 理解 的 UML 图 。 毕 竟 ， 软 件 开发 行业 在 过 去 十 年 已 经 有 了 长 足 发 展 ， 
寺 别 是 敏捷 宣言 的 影响 以 及 由 此 催生 的 大 量 技术 。 


测试 驱动 开发 与 图 表 


测试 驱动 开发 (TDD ) 是 一 个 例子 , 它 是 那些 你 要 么 爱 要 么 恨 的 技术 之 一 。 我 们 不 讨论 TDD 
是 不 是 软件 设计 的 “最 佳 方式 ”, 确实 有 很 多 人 使 用 TDD 作为 设计 软件 的 方式 , 但 它 不 见得 适合 
每 个 人 。 带 着 写 出 一 些 生 产 代码 之 后 再 编写 测试 的 观点 在 白板 上 夯 出 一 些 设计 的 草图 , 这 也 没有 
错 。 无 论 布道 者 说 什么 ，TDD 都 不 是 银 弹 。 


我 是 一 个 非常 视觉 化 的 人 , 属于 后 一 个 阵营 。 我 喜欢 在 试图 找到 解决 方案 之 前 ， 先 将 问题 可 
视 化 。 向 我 描述 业务 流程 ， 我 会 匀 画 一 个 总 结 出 来 。 跟 我 谈 商业 问题 ， 我 会 画 一 个 高 层次 领域 模 
型 。 对 我 来 说 ,可 视 化 问题 的 一 个 方法 是 提问 ， 搞 清楚 我 是 否 明 白 你 在 说 什么 。 我 也 襄 欢 把 解决 
方案 画 出 来 ， 因 为 它 是 让 一 切 都 公开 化 、 帮 助 其 他 人 迅速 理解 的 好 方法 。 


为 什么 人 们 应 该 学 习 如 何 画 草图 


为 什么 这 是 一 项 值得 人 们 学 习 的 好 技能 ? 简 而 言 之 , 敏捷 ( 并 因此 快速 行动 ) 需要 良好 的 沟 
通 。 画 草图 是 在 相对 短 的 时 间 里 传达 大 量 信息 的 一 个 很 好 的 方式 , 但 这 也 是 一 项 我 们 在 软件 行业 
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中 不 再 经 常 谈论 的 技能 。 这 有 几 个 原因 : 


(1) 很 多 
没 搞 明 白 过 。 
(2) 很 多 


团队 立刻 想到 了 UML, 但 他 们 已 经 放弃 了 把 它 作 为 一 种 交流 方法 , 或 者 从 一 开始 就 
毕竟 ，UML 显然 “不 酶 ”; 
团队 不 再 用 可 视 化 的 方式 来 设计 类 ， 因 为 他 们 更 倾向 于 TDD。 


画 草 图 不 是 艺术 


我 说 的 


“ 画 草 图 ”就 是 字面 的 意思 。 我 在 12 岁 的 时 候 被 告知 ， 如 果 想 选择 艺术 作为 GCSE” 


(高 中 ) 水 平 的 科目 注定 会 失败 ， 因 此 很 讽刺 ， 我 不 会 画 画 。 但 创造 艺术 作品 的 能 力 不 是 最 重要 
的 。 相 反 ， 快 速 深 入 本 质 ， 以 其 他 人 能 理解 的 方式 总 结 要 点 ， 才 是 重要 的 。 这 是 简单 、 有 效 和 高 
效 的 沟通 方式 。 


画 草 图 不 是 综合 模型 


说 明 一 下 ， 我 不 是 在 谈论 细节 建 模 、 综 合 UML 模型 或 模型 驱动 开发 。 这 是 关于 通过 一 个 或 
多 个 简单 的 草图 ， 有 效 且 高 效 地 交流 你 正在 构建 的 软件 的 架构 。 这 让 你 可 以 : 


口 帮助 大 家 理解 正在 构建 的 “大 局 ”; 

口 在 开发 团队 中 建立 关于 构建 的 共同 愿景 ; 

口 为 开发 团队 提供 一 个 焦点 〈 比如 ， 把 草图 贴 在 墙 上 )， 让 开发 团队 里 每 个 人 都 始终 关注 软 
件 是 什么 以 及 如 何 构建 ; 

口 为 那些 新 功能 应 该 如 何 实现 的 技术 对 话 提供 一 个 关注 点 ; 

口 提供 一 个 软件 开发 者 可 以 用 来 浏览 源 代码 的 地 图 ; 

口 帮助 人 们 了 解 他 们 所 构建 的 要 如 何 融 入 “大 局 ”; 

口 帮助 你 向 开发 团队 以 外 的 人 比如 ， 运 营 和 支持 人 员 、 非 技术 的 利益 相关 者 ， 等 等 ) 解 
释 正 在 构建 的 是 什么 ; 

口 让 新 加 入 团队 的 软件 开发 者 快速 上 手 ; 

口 为 技术 提供 一 个 起 点 ， 比 如 风险 风暴 。 


对 于 软件 架构 草图 , 我 的 目标 是 确保 大 家 理解 高 层次 结构 ， 而 不 是 类 的 设计 细节 。 这 是 关于 
创建 一 个 团队 中 每 个 人 都 能 理解 和 做 出 承诺 的 愿景 。 语 境 、 容 器 和 组 件 图 通常 就 够 了 。 


画 草 图 可 以 是 协作 活动 
最 后 一 点 ,草图 可 以 是 协作 活动 ,特别 是 使 用 白板 或 活动 挂图 而 非 建 模 工具 。 相 较 于 很 多 人 


( General Certificate of Secondary Education,( 英国 面向 十 五 六 岁 学 生 的 ) 普通 中 等 教育 证 书 。 一 一 译 者 注 
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努力 追求 的 协作 自 组 织 团队 的 概念 ， 这 要 合适 得 多 ， 但 也 要 求 团 队 里 每 个 人 都 明白 如 何 画 草 网 。 

不 幸 的 是 ,在 很 多 软件 开发 团队 里 , 绘制 图 表 似 乎 已 经 失宠 , 但 这 是 每 个 软件 开发 者 必 备 的 
技能 ， 因 为 它 为 协作 软件 设计 铺 平 了 道路 , 计 集 体 代码 所 有 制 变 得 更 简单 。 每 个 软件 开发 团队 都 
能 从 几 张 高 层次 草图 中 获 益 。 


第 . 隐 色 章 
无 效 的 草图 


过 去 的 几 年 中 , 我 发 现 很 多 软件 开发 团队 都 努力 地 对 他 们 所 构建 系统 的 软件 架构 进行 可 视 化 
和 交流 。 我 认为 主要 有 三 个 原因 。 


(1) 在 很 多 软件 团队 加 快 采用 敏捷 方法 的 过 程 中 ， 都 把 精华 和 糟粕 一 起 泌 掉 了 : 建 模 和 文档 
随 着 传统 的 计划 了 驱动 的 过 程 和 方法 论 一 起 被 扔 掉 了 。 

(2) 看 不 到 文档 和 图 表 的 价值 的 团队 ， 往 往 也 抛弃 了 统一 建 模 语言 (UML， 当 然 ， 假 设 他 们 
一 开始 也 在 用 )， 转 而 使 用 更 轻 量 和 务实 的 方法 。 基 于 与 上 千 名 软件 开发 者 的 会 议和 交谈 ， 我 党 
握 的 证 据 显示 ， 多 达 九 成 的 软件 开发 者 都 不 使 用 UML。 

(3) 很 少 有 人 教 软 件 团 队 如 何 有 效 地 可 视 化 、 建 模 和 交流 软件 架构 。 并 且 ， 从 我 为 一 些 计 算 
机 科学 的 学 生 举 办 的 培训 班 来 看 ， 大 学 也 是 如 此 。 


如 果 在 大 多 数 软件 开发 团队 的 办 公 室 里 晃 悠 足够 长 的 时 间 , 你 一 定 能 找到 一 些 草图 , 不 是 画 
在 白板 上 , 就 是 办 公 桌 上 的 废 纸 上 。 草图 是 捕捉 和 呈现 软件 架构 的 好 方法 , 但 它们 通常 缺少 UML 
图 的 正规 和 严谨 。 这 未 必 是 一 件 坏事 , 但 图 表 确 实 需要 能 被 理解 ,这 也 是 事情 开始 变 得 棘手 的 地 
方 。 过 去 几 年 我 为 上 千 人 举办 过 软件 架构 草图 专题 研讨 会 , 可 以 毫 无 疑问 地 说 大 多 数 人 都 觉得 这 
件 事 很 难 。 下 面 选 出 了 一 小 部 分 来 自 这 些 专题 研讨 的 照片 , 各 组 人 尝试 交流 他 们 对 金融 风险 系统 
案例 的 软件 解决 方案 。 挨 个 看 看 , 问 问 你 自己 , 他们 是 不 是 在 以 有 效 的 方式 交流 解决 方案 的 软件 
架构 。 有 些 图 表 使 用 了 颜色 ， 如 果 你 在 黑白 的 电子 书 阅读 器 上 阅读 本 书 ， 我 向 你 表示 歉意 。 


采购 清 * 
无 论 这 张 图 是 软件 架构 图 还 是 一 套 软件 架构 图 中 的 一 张 ,都 没有 太 多 解决 方案 的 内 容 ,基本 34 
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上 只 是 一 个 技术 采购 清单 。 


它 有 一 个 UNIX 框 和 一 个 Windows 框 , 还 有 一 些 附加 的 产品 选择 , 包括 JBoss (一 个 Java EE 
应 用 程序 服务 器 ) 和 微软 SQL 服务 器 。 问 题 在 于 ， 我 不 知道 那些 产品 做 了 些 什 么 ，UNIX 框 和 
Windows 框 之 间 似 乎 也 缺少 某 种 联系 。 既然 职 责 和 交互 没有 显示 出 来 , 这 个 图 可 能 更 适合 用 符号 
列表 来 展示 。 


只 有 框 没有 线 
当 人 们 谈论 软件 架构 ， 他 们 往往 指 的 是 “ 框 线 图 "。 下 面 这 个 图 只 有 框 ， 却 没有 线 。 


这 是 一 个 采用 微软 技术 栈 的 三 层 解 决 方案 (在 我 看 来 ), 顶部 是 一 个 ASPNET 的 Web 层 , 我 
认为 它 被 用 于 某 种 用 户 交 互 ， 尽 管 图 中 没有 明示 。 底 部 标 有 “SQL 服务 器 ”， 有 很 多 独立 的 “ 数 
据 库 饶 ”。 老 实说 ， 我 不 知道 这 些 是 不 是 独立 的 数据 库 服务 器 、 结 构 或 表 。 


最 后 ， 中 间 是 一 些 框 的 集合 ， 我 觉得 像 是 组 件 、 服 务 、 模 块 等 。 从 另 一 个 角度 来 看 ， 能 看 到 
整个 解决 方案 的 中 间 层 如 何 分 解 成 更 小 块 , 非常 好 , 这 肯定 是 我 在 解决 方案 中 希望 看 到 的 。 但 是 ， 
还 是 没有 职责 和 交互 。 软 件 架构 是 关于 结构 的 ， 是 事物 〈 框 ) 以 及 它们 如 何 相 互 作 用 ( 线 ) 这 
图 有 一 点 是 其 他 图 不 具备 的 ， 它 讲述 了 一 个 故事 ， 尽 管 还 不 完整 。 
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“功能 视图 ” 
这 个 图 跟 上 一 个 很 相似 ， 也 很 常见 ， 由 于 某 些 原因 ， 在 大 型 组 织 中 尤其 常见 。 


功 外用 图 


| 文件 答 索 器 | 


二 


基本 上 , 做 出 这 张 图 的 这 个 组 也 把 他 们 对 解决 方案 进行 功能 分 解 的 过 程 做 了 简单 的 文档 , 我 
同样 假设 是 组 件 、 服 务 、 模 块 等 。 它 也 面临 着 和 前 一 张 图 相同 的 问题 ( 没有 职责 和 交互 )， 除 此 
之 外 我 们 还 要 破解 颜色 编码 。 你 能 说 出 来 这 些 颜 色 各 自 代表 的 意义 吗 ? 它 是 不 是 跟 输 入 和 输出 服 
务 有 关 ? 或 者 也 可 能 是 业务 和 基础 设施 ?已 有 和 新 增 ? 购买 和 构建 ? 或 者 可 能 只 是 每 个 人 手 里 
的 笔 颜 色 不 一 样 ! 天 知道 ! 经 常 有 人 问 我 为 什么 中 间 的 “风险 评 佑 处 理 器 ”的 边框 明显 比 其 他 的 
粗 ? 我 真 的 不 知道 ， 但 我 怀疑 原因 只 是 马克 笔 的 角度 不 太一 样 。 
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这 是 我 最 喜欢 的 图 之 一 ， 也 是 该 小 组 用 来 展示 他 们 解决 方案 的 唯一 一 张 图 。 


这 张 图 的 中 轴线 很 不 错 ， 因 为 它 展示 了 数据 如 何 从 源 数 据 系统 (TDS 和 RDS ) 进入 ， 然 后 
经 过 一 系列 步骤 导入 数据 ,执行 计算 ,生成 报告 并 最 终 分 发 。 这 是 一 个 超级 简单 的 活动 图 ， 对 
于 系统 在 做 什么 提供 了 一 个 很 好 的 高 层次 概览 。 但 接 下 来 一 切 就 都 不 对 劲 了 。 


我 认为 图 右 侧 的 绿 圈 很 重要 ， 因 为 一 切 都 指向 它 , 但 我 不 知道 原因 。 还 有 一 个 时 钟 ， 我 感觉 
这 意味 着 有 事情 会 在 某 个 特定 的 时 候 发 生 。 只 能 祈祷 它 不 是 定时 炸弹 吧 ! 

图 的 左 侧 同 样 令 人 困惑 , 各 种 不 同 颜 色 和 样式 相互 纠缠 。 如 果 你 仔细 看 ,就 会 发 现 字 母 “UI” 
是 倒 过 来 的 。 说 不 定 把 这 张 图 像 折纸 游戏 那样 到 起 来 ， 会 更 有 意义 ? 


一 般 正 确 

这 是 另 一 种 样式 很 常见 的 图 。 下 次 再 有 人 要 你 做 一 个 系统 的 软件 架构 图 , 把 这 张 图 给 他 们 就 
完事 了 ! 

这 是 一 个 很 有 “软件 架构 入 门 ”风格 的 图 ， 其 中 大 部 分 内 容 都 是 通用 的 。 不 看 图 顶部 的 源 数 
据 系统 (TDS 和 RDS )， 我 们 有 笼统 地 标 着 运输 、 归 档 、 审 计 、 报 告 生 成 、 错 误 处 理 的 框 ， 标 着 
错误 和 动作 的 箭头 。 哦 ， 看 看 中 间 的 框 一 还 标 着 “业务 逻辑 ”。 你 构建 过 实现 “业务 逻辑 ”的 
软件 吗 ? 


有 很 多 方法 可 以 让 这 张 图 变 得 更 有 效 , 但 只 要 把 “业务 逻辑 ”替换 成 “金融 风险 计算 器 ”就 
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至 少 点 出 了 我 们 操作 的 业务 领域 。 在 Screamineg hrchitecture" 一 文中 , 鲍 勃 :马丁 大 权 说 ， 代 码 组 
织 应 该 强调 跟 业 务 领域 相关 的 东西 。 软 件 架 构图 也 应 如 此 。 


推迟 技术 


这 张 图 也 比较 常见 。 它 展示 了 软件 架构 的 整体 形态 ( 包括 职责 ， 这 一 点 我 很 言 欢 )， 但 把 技 
术 选 择 留 给 了 你 的 想象 力 。 


四 


本 书 的 其 他 部 分 会 更 详细 地 讨论 包含 或 遗漏 技术 选择 的 问题 ， 但 基本 上 有 一 个 误解 :“ 软 件 
架构 ”图 本 质 上 应 该 是 概念 化 的 , 不 应 该 包含 技术 选择 。 毕 竟 , 我 经 常 听 别 人 说 金融 风险 系统 “是 


34 
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一 个 简单 的 解决 方案 ， 可 以 用 任何 技术 构建 "。 


部 署 和 执行 上 下 文 


接 下 来 是 由 一 个 Web 应 用 程序 和 一 堆 服 务 端 组 件 构成 的 Java 解决 方案 。 尽 管 它 为 这 一 方案 
提供 了 一 个 简单 的 高 层次 概览 ， 还 是 缺少 了 一 些 信息 ， 你 要 靠 经 验 猜 出 这 些 空白 。 


如 果 你 看 看 图 中 心 的 Unix 框 ， 就 会 看 到 两 个 更 小 的 ， 标 有 “风险 分 析 系 统 ” 和 “数据 导入 
服务 ”的 框 ,仔细 点 ,还 会 看 到 这 两 个 框 上 注 明 了 “JAR”, 这 是 Java 代码 的 部 署 机 制 ( Java ARchive， 
Java 档案 )。 基 本 上 这 是 一 个 包含 编译 后 的 Java 字 节 码 的 压缩 文件 ， 相 当 于 .NET 的 DLL 文件。 


这 里 存在 歧义 。 如 果 你 把 一 个 JAR 文件 放 在 Unix 框 里 会 发 和 后 什么 ? 答案 是 除了 占用 一 些 磁 
盘 空 间 ， 什 么 也 没有 。cron ( Unix 调度 器 ) 不 会 执行 JAR 文件 ， 除 非 它 们 真 的 是 独立 的 控制 台 
应 用 程序 ， 那 种 以 “public static void main” 方 法 作为 程序 人 口 的 。 然 后 通过 推导 , 我 认为 这 两 个 
JAR 文件 实际 上 都 是 独立 的 应 用 程序 ,这 也 是 我 希望 在 图 上 看 到 的 。 我 想 了 解 执行 上 下 文 ， 而 不 
是 部 署 机 制 。 


太 多 假设 
下 面 的 图 告诉 我 们 解决 方案 是 一 个 多 层 Java EE 系统 ， 但 它 忽略 了 一 些 重要 的 细节 。 


对 于 通信 是 如 何 发 生 的 ，Web 服务 器 和 应 用 程序 服务 器 之 间 的 连 线 没有 提供 任何 信息 。 是 
SOAP 、RESTful 服务 、HTTP 请 求 的 XML、 远程 方法 调用 、Windows 通信 基础 、 还 是 异步 消息 ? 
答案 是 不 清楚 ， 我 考虑 这 一 点 有 三 个 理由 。 
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(1) 约束 : 如 果 是 在 一 个 存在 约束 的 环境 中 工作 ， 技 术 的 选择 可 能 已 经 为 你 做 好 了 。 比 如 ， 
你 可 能 有 进程 间 通 信 的 标准 ， 或 者 只 允许 某 些 类 型 的 流量 通过 的 防火 墙 。 

(2) 非 功 能 需求 : 技术 和 协议 的 选择 可 能 会 影响 到 你 能 否 满足 非 功能 需求 ， 特 别 是 如 果 你 正 
在 处 理 高 性 能 、 可 伸缩 性 和 安全 性 。 

(3) 复杂 度 : 我 曾经 与 从 未 创建 过 多 层 架 构 的 软件 团队 一 起 工作 ， 他 们 往往 误 以 为 这 种 架构 
风格 可 以 “不 费 吹 灰 之 力 ”得 来 。 在 现实 世界 中 ， 更 多 分 层 意味 着 更 高 的 复杂 度 。 


就 算 有 很 多 选项 , 团队 往往 也 不 喜欢 在 把 一 些 原型 组 成 整体 之 前 就 匆匆 提交 。 没 问题 ， 只 是 
换 成 用 潜在 选项 清单 来 注释 图 上 那些 线 ， 这 样 至 少 我 们 能 更 好 的 对 话 。 


无 家 可 归 的 C# 对 象 (HOCO) 


如 果 你 听 说 过 “简单 的 C# 对 象 ”( POCO ,Plain Old C# Objects ) 或 “简单 的 Java 对 象 ”( POJO， 
Plain Old Java Objects )， 这 就 是 无 家 可 归 的 版 本 。 这 张 图 混合 了 许多 不 同 层次 的 细节 。 


图 的 左下 部 是 一 个 SQL 服务 器 数据 库 ， 左 上 部 是 一 个 标 为 “应 用 程序 ”的 框 。 注 意 ， 那 个 
框 同时 还 ( 用 绿色 ) 注 明 了 “控制 台 - C#”。 基 本 上 ， 这 个 系统 似乎 是 由 一 个 C# 控 制 台 应 用 程序 
和 一 个 数据 库 构成 的 。 但 其 他 的 框 是 什么 ? 


它们 中 大 多 数 似乎 是 C# 组 件 、 服 务 、 模 块 或 对 象 ， 跟 我 们 在 其 他 图 里 已 经 看 过 的 很 像 。 还 有 
一 个 “数据 访问 ” 框 和 “记录 器 ” 框 ， 可 能 是 框架 或 架构 层 。 所 有 这 些 框 是 否 都 代表 了 跟 控 制 台 应 
用 程序 和 数据 库 相 同 级 别 的 粒度 , 或 者 它们 实际 上 是 应 用 程序 的 一 部 分 ? 我 猜 是 后 者 , 但 缺少 边界 
让 这 张 图 令 人 困惑 。 我 想 在 大 多 数 框 周围 再 画 一 个 大 框 ,“ 所 有 这 些 东西 都 属于 控制 台 应 用 程序 "。 
我 想 给 那些 框 一 个 家 。 我 想 要 理解 系统 如 何 被 分 解 成 更 小 的 组 件 ， 同 时 还 想 了 解 执行 上 下 文 。 
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选择 你 自己 的 冒险 
这 是 一 张 图 的 中 间 部 分 ， 全 图 更 复杂 。 


这 有 点 像 我 在 孩童 时 代 读 过 的 那些 “选择 你 自己 的 冒险 ”的 书 。 你 可 以 从 第 1 页 开始 阅读 ， 
并 最 终 到 达 一 个 故事 的 分 又 点 ， 自 己 决 定 接 下 来 要 怎么 做 。 如 果 想 攻击 一 个 遇 到 的 大 怪兽 ， 翻 到 
47 页 。 如 果 想 像 恬 夫 一 样 逃跑 , 那 就 到 205 页 。 要 一 直 做 类 似 的 选择 , 最 后 , 如 果 你 的 角色 死 了 ， 
就 必须 重新 开始 ， 很 讨厌 。 


这 张 图 也 是 如 此 。 从 顶部 开始 , 一步 步 向 下 , 这 是 一 个 复杂 的 异步 事件 驱动 的 架构 风格 。 你 
常常 要 做 出 选择 : 应 该 顺 着 “失败 事件 ”还 是 “完成 事件 ”"。 在 这 本 书 里 ， 所 有 的 路 径 最 终 都 会 
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走向 图 左 侧 的 (SNMP”) 陷阱 。 


这 张 图 很 复杂 , 它 试图 展示 一 切 ， 只 用 一 种 颜色 却 显得 力不从心 。 去 掉 一 些 信息 或 使 用 多 种 
颜色 来 突出 架构 中 不 同 的 路 径 ， 效 果 会 非常 好 。 


应 该 用 白板 
最 后 一 张 图 作为 例子 很 好 地 解释 了 为 什么 白板 是 有 很 用 的 工具 。 


创建 有 效 的 草图 


这 些 示 例 图 代表 我 最 初 和 软件 团队 一 起 工作 , 帮助 他 们 更 好 地 以 可 视 化 的 方式 交流 软件 架构 
时 看 到 的 一 些 东西 。 哦 ， 别 以 为 微软 Visio 能 帮 上 什么 忙 ! 它 往往 只 会 让 事情 变 得 更 糟 ， 因 为 现 
在 人 们 还 要 和 工具 纠缠 。 通 过 快速 的 谷歌 图 片 搜索 ， 我 发 现 了 下 面 这 张 图 ”， 其 中 有 很 多 跟 我 们 
已 经 看 过 的 图 相同 的 问题 。 我 敢 肯 定 ， 你 兽 看 到 这 样 的 图 。 根 据 我 的 经 验 ， 中 心 化 架构 团队 喜欢 
这 类 东西 。 

使 用 UML 可 以 避免 很 多 这 样 的 陷阱 ， 但 现在 似乎 没有 太 多 人 有 热情 去 学 习 这 东西 。 简 单 而 
有 效 的 软件 架构 草图 是 每 个 人 都 可 以 完成 的 ， 所 需 的 不 过 是 一 些 简单 的 建议 和 一 组 通用 的 抽象 。 


Q@ Simple Network Management Protocol， 简 单 网 络 管理 协议 。 译 者 注 
© https://www.google.comy/search?q=software+architecture+diagrams&ctbm=isch 
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从 谷歌 图 像 搜 索 找到 的 一 些 典 型 的 框图 


第 章 
C4: 语 境 、 容 器 、 组 件 和 类 


在 任何 软件 系统 的 开发 周期 内 ,代码 都 是 最 受 关注 的 部 分 。 这 很 正常 ， 因 为 最 终 交 付 的 只 有 
代码 。 但 如 果 要 向 别人 解释 系统 如 何 工 作 ， 你 会 一 来 就 说 代码 吗 ? 


可 惜 ， 代 码 并 非 全 部 。 在 缺少 文档 的 情况 下 ， 人 们 通常 会 在 白板 或 纸 上 画 框 线 , 来 解释 哪些 
是 主要 的 结构 单元 以 及 它们 如 何 相互 连接 。 用 图 片 描述 软件 时 ， 我 们 会 倾向 于 制作 一 个 超级 图 ， 
尽 可 能 多 地 把 各 个 抽象 层次 的 细节 都 塞 进去 。 这 可 能 是 因为 我 们 在 预 设 问题 ， 或 者 有 点 过 于 关注 
系统 在 代码 层面 的 运行 细节 。 这 样 的 图 往往 乱 成 一 团 ， 既 复杂 又 令 人 费解 。 选 择 一 个 Microsoft 
Visio 、Rational Software Architect 或 Sparx Enterprise Architect 之 类 的 工具 ， 不 但 不 会 让 事情 变 得 
简单 ， 往 往 更 复杂 。 

更 好 的 方法 是 制作 一 些 抽象 层次 各 异 的 图 。 比 起 一 张 试图 讲 清 所 有 事情 的 复杂 图 , 多 张 简单 
图 可 以 更 有 效 地 描述 软件 。 


通用 的 抽象 集合 


如 果 软 件 架构 是 关于 软件 系统 的 结构 , 那 就 有 必要 理解 哪些 是 主要 结构 单元 , 以 及 它们 如 何 
在 不 同 的 抽象 层次 上 相互 融合 。 

假设 一 个 软件 使 用 了 面向 对 象 的 编程 语言 , 我 喜欢 用 如 下 方式 来 思考 它 的 结构 : 软件 系统 由 
多 个 容 右 构成 ， 容 右 又 由 多 个 组 件 构成 , 组件 由 一 个 或 多 个 类 实现 。 大 多 数 软件 系统 都 可 以 用 这 
种 简单 的 逻辑 结构 单元 的 层级 关系 来 建 模 。 


口 类 : 对 我 们 大 多 数 人 来 说 ， 在 一 个 面向 对 象 的 世界 里 ， 类 是 软件 系统 的 最 小 结构 单元 。 
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口 组 件 : 组 件 可 以 想象 成 一 个 或 多 个 类 组 成 的 逻辑 群 组 。 比 如 ， 其 他 组 件 可 以 使 用 审计 组 
件 或 认证 服务 ， 来 确定 对 特定 资源 的 请 求 是 否 放行 。 组 件 通常 由 多 个 类 在 更 高 层次 的 约 
束 下 组 合 而 成 。 

口 容器 : 容器 是 指 一 个 在 其 内 部 可 以 执行 组 件 或 驻 留 数据 的 东西 。 它 可 以 是 从 网 络 或 应 用 
服务 器 直到 富 客户 端 应 用 或 数据 库 的 任何 东西 。 作 为 整个 系统 的 一 部 分 ， 容 器 通常 是 可 
执行 文件 ， 但 未 必 是 各 自 独立 的 流程 。 比 如 ， 我 把 每 个 Java EE 网 络 应 用 或 .NET 网 站 都 
看 作 一 个 独立 的 容器 ， 不 管 它们 是 否 运行 在 同一 个 物理 服务 器 流程 中 。 从 容器 的 角度 理 
解 一 个 软件 系统 的 关键 在 于 ， 任 何 容 妖 间 的 通信 可 能 都 需要 一 个 远程 接口 ， 比 如 SOAP 
网 络 服务 、RESTful 接口、Java RMI、Microsoft WCF 、 报 文 ， 等 等 。 

口 系统 : 系统 是 最 高 的 抽象 层次 ,代表 了 能 够 提供 价值 的 东西 。 一 个 系统 由 多 个 独立 的 容 
器 构成 ， 例 如 金融 风险 管理 系统 、 网 络 网 银行 系统 、 网 站 等 。 


架构 结构 的 简单 模型 


通过 精确 定义 各 种 结构 单元 并 特 化 它们 之 间 的 联系 , 我 们 不 难看 出 如 何 更 进一步 。 但 是 我 不 
确定 这 会 特别 有 用 ， 因 为 它 会 限制 和 复杂 化 我 们 的 目标 : 理解 软件 系统 的 结构 ,并 建立 能 描述 它 
的 、 简 单 的 抽象 集合 。 


总 结 软件 的 静态 视图 
我 总 结 软件 的 静态 视图 时 ， 大 概 会 凭借 脑海 中 的 抽象 集合 ， 面 出 如 下 几 类 图 。 
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(1) 语 境 : 设 定 场景 的 高 层次 图 ， 包 括 关键 的 系统 依赖 和 参与 者 。 

(2) 容器 : 容器 图 显示 了 高 层次 的 技术 选择 ， 容 顺 如 何 分 担 职责 、 如 何 通 信 。 

(3) 组 件 : 组 件 图 可 以 让 你 看 到 每 个 容 噩 的 关键 逻辑 组 件 及 之 间 的 关系 。 

(4) 类 : 这 是 一 个 可 选 的 细节 层次 。 如 果 想 解释 某 个 模式 或 组 件 将 (或 已 经 ) 被 怎样 实现 ， 
我 会 夯 少量 高 层次 UML 类 的 图 。 促 使 我 给 软件 系统 的 部 分 分 类 画图 的 原因 包括 软件 的 复杂 性 ， 
团队 的 规模 和 经 验 。 我 画 的 UML 图 通常 会 是 草图 而 非 综合 性 的 模型 。 


一 


通用 标记 法 的 通用 抽象 


画 简单 草图 对 我 和 合作 过 的 很 多 团队 都 管用 。 但 这 是 为 了 提供 结构 性 的 想法 和 指导 ,而 非 制 
订 标 准 。 目标 是 帮助 团队 以 有 效 且 高 效 的 方式 沟通 他 们 的 软件 设计 ,而 非 创 造 男 一 套 综合 性 的 建 
模 标 记 。 

UML 提供 了 一 套 通用 的 抽象 和 用 于 摘 述 它们 的 通用 标记 ,但 我 几乎 看 不 到 哪个 团队 可 以 有 
效 地 使 用 它们 。 我 更 愿意 看 到 团队 能 够 以 通用 的 抽象 来 讨论 他 们 的 软件 系统 ,而 不 是 绞 尽 脑汁 去 
理解 各 种 标记 元 素 想 要 展现 的 东西 。 至 于 我 嘛 ， 一 套 通用 抽象 比 通用 标记 更 重要 。 


大 多 数 地 图 在 履行 这 一 准则 上 都 是 很 好 的 例子 。 它 们 都 显示 了 道路 、 河 流 、 湖 泊 、 森 林 、 城 
镇 、 教 堂 等 ,但 通常 依据 颜色 编码 、 线 条 样式 、 图 标 等 ， 使 用 不 同 的 标记 。 理 解 它 们 的 关键 就 是 
放置 在 地 图 一 角 的 图 例 。 在 软件 架构 图 中 ， 我 们 同样 可 以 使 用 图 例 。 


必须 重申 ， 非 正规 的 框 线 草图 提供 灵活 性 的 代价 就 是 一 致 性 ， 因 为 你 创造 了 你 自己 的 标记 ， 
而 不 是 使 用 UML 等 的 标准 。 我 的 建议 是 注意 颜色 编码 、 线 条 样式 、 形 状 等 ， 让 你 的 团队 自然 发 
展 出 一 致 的 标记 。 给 每 个 图 都 添加 一 个 解释 标记 的 简单 图 例 , 这 会 很 有 帮助 。 如 果 命 名 真 的 是 软 
件 开发 中 最 难 的 事情 ,就 尽量 避免 一 个 图 里 都 是 带 标签 的 框 。 标 出 框 的 含义 有 助 于 避免 上 收 义 ， 同 
时 提供 一 个 “一 目 了 然 ”的 友好 视图 。 


图 应 该 简单 且 脚 踏实 地 


似乎 有 一 个 普遍 的 误解 ,，“ 架 构图 ”只 能 展示 高 层次 的 概念 视图 ， 所 以 难怪 软件 开发 者 常常 
认为 它们 毫 无 意义 。 软 件 架 构图 应 该 脚踏实地 ， 软 件 架 构 流程 应 该 关乎 编码 、 指 导 和 合作 ， 而 不 
是 象牙 塔 。 在 架构 图 中 包含 技术 选择 (或 可 选项 ) 通 带 是 朝 正 确 方向 迈 出 的 一 步 ， 可 以 让 图 看 起 
来 不 像 由 一 堆 概念 组 件 神奇 地 组 合成 一 个 端 到 端 软 件 系统 的 象牙 塔 架构 。 

一 张 图 可 以 很 快 变 得 乱七八糟 ， 但 一 组 简单 的 图 让 你 可 以 有 效 地 从 不 同 抽象 层次 展示 软件 。 
这 意味 着 说 明 你 的 软件 会 是 一 个 又 快 又 简单 的 任务 , 只 需要 花 一 点 精力 随时 更 新 那些 图 。 你 永远 
不 知道 ， 其 他 人 也 可 以 看 懂 它 们 。 
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三 境 氏 


给 软件 系统 画图 和 做 文档 时 ， 语 境 图 是 很 有 用 的 起 点 ， 让 你 可 以 后 退 一 步 观察 大 局 。 


i 
意图 
语 境 图 能 帮 你 回答 下 面 这 些 问 题 : 


(1) 我 们 构建 的 〈 或 已 经 构建 的 ) 软件 系统 是 什么 ? 
(2) 谁 会 用 它 ? 
(3) 如 何 融 入 已 有 的 IT 环境 ? 


结构 


在 中 间 画 一 个 简单 的 框图 展示 你 的 系统 , 周 于 是 它 的 用 户 和 其 他 与 之 相互 作用 的 系统 。 比 如 ， 
对 金融 风险 系统 的 解决 方案 就 会 画 出 下 面 这 样 的 图 。 细节 在 这 里 并 不 重要 ,因为 它 是 你 用 来 展示 
系统 大 局 景观 的 广角 视图 。 重 点 应 该 放 在 人 和 系统 上 ， 而 不 是 技术 和 协议 。 


这 些 示例 图 展示 了 这 个 风险 系统 ， 被 它 的 用 户 和 其 他 所 依赖 的 I 开 系 统 围 在 中 间 。 
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金融 风险 系统 ( 见 附 录 ) 的 语 境 图 示例 


用 户 、 演 员 、 角 色 、 人 物 等 
这 些 是 系统 的 用 户 。 这 个 风险 系统 的 用 户主 要 有 两 大 类 : 


口 业务 用 户 ( 可 以 查看 生成 的 风险 报告 ); 
口 管理 用 户 ( 可 以 修改 风险 计算 过 程 所 用 的 参数 )。 


IT 系统 
根据 不 同 的 环境 和 选择 方案 ， 你 可 能 想 要 在 风险 系统 语 境 图 上 展示 的 其 他 IT 系统 包括 : 


口 交易 数据 系统 ( 金融 交易 数据 源 ); 

口 参考 数据 系统 (参考 数据 源 ); 

口 中 心 监测 系统 ( 警报 发 往 的 地 方 ); 

口 活动 目录 或 LDAP ( 认证 和 授权 用 户 ); 

口 微软 SharePoint 或 其 他 内 容 / 文 档 管理 系统 ( 分 发 报告 ); 
口 微软 Exchange( 向 用 户 发 送 电 子 邮 件 )。 


交互 


背 助 一 些 关 于 目标 的 信息 ， 对 标注 交互 行为 ( 用户 <-> 系统 、 系 统 <-> 系统 ， 等 等 ) 非常 
有 用 , 而 不 仅仅 是 由 一 堆 框 和 意义 不 明 的 连接 线 组 成 的 图 。 比如, 标注 用 户 对 系统 的 交互 行为 时 ， 
我 往往 会 做 一 张 包含 重要 用 例 /用 户 故事 的 简短 符号 列表 ， 以 此 来 总 结 特定 类 型 的 用 户 如 何 与 系 
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统 交 互 。 
动机 
你 可 能 会 问 ， 这 么 简单 的 图 有 什么 意义 。 下 面 就 告诉 你 为 什么 它 很 有 用 : 


口 使 语 境 更 明确 ， 这 样 就 不 需要 假设 ; 

口 从 一 个 较 高 层次 展示 了 正在 向 已 有 的 IT 环境 中 添加 的 是 什么 ; 

口 技术 和 非 技术 的 人 员 可 以 当 作 讨论 起 点 的 一 种 高 层次 图 表 ; 

口 牵涉 到 理解 系统 间接 口 的 问题 时 ， 为 你 识别 可 能 需要 沟通 的 人 提供 了 一 个 起 点 。 


语 境 图 不 会 展示 太 多 细节 , 但 确实 有 助 于 做 好 准备 工作 ,是 其 他 图 表 的 起 点 。 最 后 ， 夯 语 境 
图 应 该 只 需要 几 分 钟 时 间 ， 因 此 真 的 没有 理由 不 做 这 件 事 。 


世人 入 
学 从 


口 直接 的 软件 开发 团队 内 部 人 员 ， 外 部 的 技术 和 非 技术 人 员 。 


示例 


让 我 们 看 一 个 例子 。“ 技 术 部 落 ” 网 站 "为 在 泽 西 岛 和 格 恩 西 岛 (海峡 群岛 中 最 大 的 两 个 岛屿 ) 
寻找 与 技术 、IT 和 数字 领域 相关 的 人 、 部 落 ( 业务 、 社 区 、 兴 趣 组 等 ) 和 内 容 提供 了 一 个 途径 。 
在 最 基本 的 层面 上 ， 它 是 一 个 本 地 的 微 博 、 新 闻 、 博 文 、 活 动 、 讲 座 、 工 作 以 及 更 多 东西 的 内 容 
聚合 器 。 这 是 一 个 提供 可 视 化 总 结 的 语 境 图 。 


细 闻 在 这 里 不 重要 ， 因 为 这 是 你 退 后 一 步 看 到 的 。 重 点 应 该 放 在 人 《演员 、 角 色 、 人 物 等 ) 
和 软件 系统 上 ， 而 不 是 技术 、 协 议和 其 他 底层 细节 。 


CD http://techtribes.je 


A 
oh 
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”过 < 处 部 系统 >> 、 


六 


匿名 用 户 认证 用 户 (通过 管理 用 户 (通过 


Twitter ID 登 录 ) witter ID 登录 ) 


管理 用 户 信息 
和 部 落成 员 


查看 本 地 的 技术 、 数 字 和 IT 领域 
的 人 人、 部落 (业务 、 社 区 、 兴 下 
组 ) 、 内 容 、 活 动 、 工 作 等 添加 入， 添加 部 落 
以 及 管理 部 落成 员 


techtribes.je 


dl06 


四 


获取 配置 信 获取 RSS 和 Atom 
息 和 微 博 订阅 的 内 容 


获取 代码 仓库 信息 


<< 外 部 系统 >> “ 
GitHub 


- 


Twitter 


吧 
< 


技术 部 落 - 语 境 


7 
站 


网 专 


呀 泪 


且 通 过 语 境 图 了 解 了 你 的 系统 如 何 融和 人 整个 IT 环境 ， 真 正 有 用 的 下 一 步 就 是 通过 容器 图 
说 明 高 层次 的 技术 选择 。 


意图 


容器 图 可 以 帮助 你 回答 下 面 的 问题 。 


(1) 软件 系统 的 整体 形态 是 什么 样 的 ? 

(2) 高 层次 技术 决策 有 哪些 ? 

(3) 职责 在 系统 中 如 何 分 布 ? 

(4) 容 需 之 间 如 何 相 互 交流 ? 

(5) 为 了 实现 特性 ， 作 为 一 个 开发 者 ， 我 需要 在 哪里 写 代 码 ? 


结构 

画 一 个 简单 的 框图 来 展示 你 的 关键 技术 选择 。 比 如 ， 如 果 画 金融 风险 系统 的 解决 方案 图 , 根 
据 你 的 解决 方案 ， 大 概 会 画 出 下 面 这 样 的 图 。 

这 些 示例 图 展示 了 组 成 风险 系统 的 不 同 的 Web 服务 器 、 应 用 服务 器 、 独 立 应 用 程序 、 数 据 
库 、 文 件 系 统 ， 等 等 。 包含 一 些 语 境 图 的 概念 往往 对 丰富 内 容 很 有 用 ， 比 如 用 户 和 风险 系统 依赖 
的 其 他 IT 系统 。 


虹 


这 里 说 的 “容器 " ， 指 的 是 组 成 软件 系统 的 逻辑 上 的 可 执行 文件 或 过 程 ， 诸 如 : 

口 Web 服务 器 " ( 比如 Apache HTTP 服务 器 、Apache Tomcat、 微 软 IIS、WEBrick 等 ); 

口 应 用 服务 器 (如 IBM WebSphere、BEA/Oracle WebLogic 、JBoss AS 等 ); 

口 企业 服务 总 线 和 业务 流程 编排 引擎 ( 如 Oracle Fusion 中 间 件 等 ); 

口 SQL 数据 库 ( 如 Oracle、Sybase、 微 软 SQL 服务 器 、MySQL、PostgreSQL 等 ); 

口 NoSQL 数据 库 ( 如 MongoDB 、CouchDB 、RavenDB 、Redis 、Neo4j 等 ); 

口 其 他 存储 系统 ( 如 亚马逊 83 等 ); 

口 文件 系统 ( 特别 是 如 果 你 在 数据 库 以 外 读 / 写 数据 ); 

口 Windows 服务 ; 

口 独立 /控制 台 应 用 程序 ( 即 “public static void main” 风格 的 应 用 程序 ); 

口 Web 浏览 器 和 插件 ; 

口 cron 和 其 他 计划 的 工作 容器 。 

图 上 的 每 一 个 容器 都 可 以 指定 下 面 这 些 项 。 

口 名 称 : 容器 的 逻辑 名 称 (如 “面向 互联 网 的 Web 服务 器 ”、“ 数 据 库 ”等 )。 

口 技术 : 容器 的 技术 选择 (如 Apache Tomcat 7、Oracle 11g 等 )。 

口 职责 : 容器 职责 的 高 层次 声明 或 清单 。 你 也 可 以 展示 一 张 驻 留 在 每 个 容器 中 关键 组 件 的 
小 图 ， 但 我 发 现 这 通常 会 把 图 搞 得 很 乱 。 


也 


@ 如 果 多 个 Java EE Web 应 用 程序 或 .NET 网 站 是 同一 个 软件 系统 的 部 件 , 通常 会 在 单独 的 类 加 载 器 或 应 用 程序 域 里 
被 执行 。 我 用 单独 的 容器 来 展示 它们 ， 因 为 它们 是 独立 的 , 要 靠 进 程 间 通信 ( 比如 远程 方法 调用 、SOAP、REST， 
等 ) 来 协同 工作 。 
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如 果 你 纠结 于 容 右 图 中 是 否 要 包含 一 个 框 ， 只 要 问 自己 ,这 个 框 是 否 会 (或 者 能 ) 部 署 到 一 
个 单独 的 物理 或 虚拟 硬件 上 。 你 展示 在 容器 图 上 的 每 件 东 西 都 应 该 能 够 单独 部 署 。 这 并 不 意味 着 
你 必须 将 它们 部 署 在 单独 的 基础 设施 上 ， 但 它们 应 该 能 够 单独 部 署 。 


| 


互 

容 需 间 的 通信 通常 是 进程 间 通 信 。 明 确 这 一 点 并 总 结 这 些 接口 将 如 何 工 作 是 很 有 用 的 。 和 其 
他 任何 图 相同 , 它 对 于 标注 交互 行为 非常 有 用 ， 而 不 仅仅 是 由 一 堆 框 和 连接 它们 的 含混 的 线 组 成 
的 图 。 下 面 是 一 些 有 用 的 信息 : 
口 交互 的 目的 (如 “ 读 / 写 数据 ”“ 发 送 报告 “等 ); 
口 通信 方法 (如 Web 服务 .REST 、Java 远程 方法 调用 、Windows 通信 基础 、Java 消息 服务 ); 
口 通信 方式 (如 同步 、 异 步 、 批 量 、 两 阶段 提交 等 ); 
口 协议 和 端口 号 (如 HTTP、HTTPS、SOAP/HTTP 、SMTP 、FTP、RMIIOP 等 )。 


系统 边 鹤 


如 果 你 选择 将 不 属于 你 构建 范畴 的 用 户 和 IT 系统 时 括 其 中 ， 在 适当 的 容器 周围 画 一 个 框 来 
明确 地 标定 系统 边界 可 能 是 个 好 主意 。 系 统 边界 对 应 了 语 境 图 上 的 一 个 框 ( 比如 “风险 系统 ”)。 


动机 

语 境 图 展示 的 软件 系统 是 一 个 盒子 , 容 带 图 则 是 打开 盒子 , 展示 里 面 的 东西 。 这 很 有 用 , 因为 : 
口 让 高 层次 的 技术 选择 更 明确 ; 
口 展示 了 哪些 容器 之 间 有 关联 ， 以 及 它们 如 何 沟通 
口 提供 了 一 个 放置 组 件 的 框架 ( 也 就 是 说 ， 所 有 的 组 件 都 有 一 个 家 ); 
口 展示 了 高 层次 的 语 境 图 和 通常 很 乱 的 组 件 图 之 间 经 常 缺失 的 连接 ,组 件 图 画 的 是 整个 软 

件 系统 中 所 有 的 逻辑 组 件 。 

和 语 境 图 一 样 ， 夯 容 带 图 应 该 只 需要 儿 分 钟 时 间 ， 因 此 真 的 也 没有 理由 不 做 这 件 事 。 


» 


受众 
口 直接 从 事 软件 开发 的 团队 内 部 和 外 部 技术 人 员 ; 包括 从 软件 开发 者 到 运营 和 支持 人 员 的 
每 一 个 人 。 
示例 


下 面 这 张 图 展示 了 组 成 “技术 部 落 ” 网 站 的 逻辑 容 需 。 
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简单 地 说 ,“ 技 术 部 落 ” 由 一 个 向 用 户 提供 信息 的 Apache Tomcat Web 服务 器 组 成 ， 而 信息 


则 通过 独立 的 内 容 更 新 进程 来 保持 最 新 。 


所 有 数据 都 被 存储 在 MySQL 数据 库 、MongoDB 数据 库 或 文件 系统 当中 的 一 个 


的 是 ，j 


。 值 得 指出 


这 张 图 并 未 提 及 每 个 容 需 的 物理 实例 的 数量 。 比 如 ， 可 能 有 一 片 运行 在 MongoDB 集群 上 


的 Web 服务 器 ， 但 这 张 图 并 未 展示 这 个 层次 的 信息 。 相 反 IE 
容器 图 展示 了 软件 名 & 构 的 高 层次 形态 ， 以 及 职责 如 何 分 布 。 


理 实例 、 故 障 转移 、 集 群 等 。 
示 了 主要 的 技术 选择 以 及 容器 如 何 相互 交流 。i 
持 / 运 营 人 员 很 有 用 。 


匿名 用 户 


[HTTP] 


认证 用 户 


[HTTP] 


也 展 
这 是 一 个 简单 的 高 层次 技术 图 ， 对 软件 开发 者 和 


A 


管理 用 户 


[HTTP] 


<< 容 器 >> 
Web 服 务 器 ，Apache Tomcat 7.x， 
查看 本 地 的 技术 、 数 字 和 IT 领域 的 
人 、 部 落 、 内 容 、 事 件 、 工 作 等 


了 


要 


从 [SQLJDBC 3306 端 口 ] 读 写 数据 读 取 从 [MongoDB 有 线 协议 27017 端 口 ] 读 写 数据 
<< 容 器 >> << 容 器 >> << 容 器 >> 
关系 型 数据 库 ，MySQL 5.5.x; 文件 系统 ， 查 找 索引 NoSQL 数 据 存储 MongoDB 2.2.x，; 来 | 


人 、 部 落 、 部 落成 员 、 交 谈 、 事 
件 、 工 作 、 徽 章 、GitHub 仓 库 等 


本 


从 [SQL/JDBC 3306 端 口 ] 读 写 数据 


写 人 


自 (博客 文章 的 ) RSS/Atom 订 阅 和 
微 博 的 内 容 


2 


从 [MongoDB 有 线 协 议 27017 端 口 ] 读 写 数据 


a 


<< 容 器 >> 
内 容 更 新 器 ， 独 立 的 Java 7 进程 ， 
按 计 划 更 新 配置 、 微 博 、GitHub 仓 
和 内 容 


获取 数据 [HTTP] 
“技术 部 落 " 的 系统 边界 


= -== 


Seo000000 ve- 


“技术 部 落 ” 


获取 数据 [HTTP] 


获取 数据 [HTTP] 


= 


sm 


\ 


-容器 


第 .CO 章 
组 件 图 


在 展示 了 高 层次 技术 决策 的 容器 图 之 后 , 我 将 开始 放大 ,进一步 分 解 每 一 个 容器 。 如 何 分 解 
你 的 系统 取决 于 你 自己 , 但 我 倾向 于 鉴别 主要 的 逻辑 组 件 及 其 交互 。 这 关系 到 将 一 个 软件 系统 实 
现 的 功能 划分 为 若干 不 同 的 组 件 、 服 务 、 子 系统 、 层 、 工 作 流 等 。 如 果 你 遵循 一 种 “ 纯 面 向 对 象 ” 
或 领域 驱动 设计 的 方法 ， 那 么 这 对 你 可 能 管用 ， 也 可 能 不 管用 。 


意图 
组 件 图 可 以 帮助 你 回答 下 面 的 问题 。 
(1) 系统 由 哪些 组 件 /服务 组 成 ? 


(2) 在 高 层次 上 ， 系 统 如 何 工 作 是 否 清晰 ? 
(3) 所 有 组 件 /服务 都 有 一 个 家 吗 〈 即 驻 留 在 一 个 容器 中 ) ? 


结构 


每 当 人 们 被 要 求 绘制 “架构 图 ” 时, 最 后 通常 会 绘制 一 张 展示 组 成 软件 系统 的 逻辑 组 件 的 图 。 
除了 我 们 一 次 只 想 看 一 个 容 需 中 驻 留 的 组 件 , 这 基本 上 就 是 图 的 作用 。 如 果 你 在 设计 一 个 金融 风 
险 系 统 的 解决 方案 ， 这 里 有 一 些 组 件 图 的 例子 。 

我 画 的 组 件 图 通常 只 展示 驻 留 在 单个 容器 内 的 组 件 。 这 并 不 是 一 条 规定 , 对 于 小 型 的 软件 系 
统 而 言 , 通常 也 可 以 用 一 张 图 展示 所 有 容 右 中 的 全 部 组 件 。 如 果 这 张 图 开始 变 杂 乱 ， 说 不 定 就 是 
时 候 拆 分 它 了 。 


小 
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金融 风险 系统 ( 见 附录 ) 的 组 件 图 示例 
组 件 
设计 一 个 全 融 系 统 风险 的 解决 方案 可 能 会 包括 如 下 组 件 : 


口 贸易 数据 系统 导入 带 ; 

口 参考 数据 系统 导入 器 ; 

口 风险 计算 器 ; 

口 认证 服务 ; 

口 系统 驱动 者 /协调 者 ; 

口 审计 组 件 ; 

口 通知 组 件 〈 如 电子 邮件 ); 
口 监测 服务 ; 

口 等 等 。 


这 些 组 件 是 系统 的 粗 粒度 结构 单元 ， 你 应 该 能 理解 如 何 通 过 一 个 或 多 个 组 件 实现 一 个 用 例 / 
用 户 故 事 /特性 。 如 果 能 做 到 这 一 点 ， 那 么 你 很 有 可 能 已 经 掌控 了 每 件 事 。 举 个 例子 ， 如 果 你 有 
一 个 访问 审计 系统 的 需求 ， 但 没有 审计 组 件 或 职责 ， 那 么 也 许 你 已 经 漏 掉 了 什么 。 


对 于 图 中 绘制 的 每 一 个 组 件 ， 你 都 可 以 指定 : 


口 名 称 : 组 件 的 名 称 ( 如 “风险 计算 器 ”、“ 审 计 组 件 ” 等 ); 
口 技术 : 对 组 件 的 技术 选择 ( 如: 普通 的 [JavalC#IRuby| 其 他 ] 对 象 、 企 业 JavaBean、Windows 
通信 基础 服务 等 ); 
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口 职责 : 对 组 件 职 责 的 非常 高 层次 的 声明 ( 如 : 要 么 是 重要 的 操作 名 称 ， 要 么 是 描述 职责 


的 简短 句子 )。 
交互 


为 其 他 类 型 的 图 重申 相同 的 建议 , 对 标注 组 件 间 的 交互 行为 非常 有 用 , 而 不 仅仅 是 由 一 堆 框 
和 意义 不 明 的 连接 线 组 成 的 图 。 下 面 是 一 些 有 用 的 信息 : 


口 交互 的 目的 (如 :“ 使 用 "、“ 存 留 贸 易 数 据 ” 等 ); 
口 通信 方式 (如 : 同步、 异步 、 批 量 、 两 阶段 提交 等 )。 


动机 


把 你 的 软件 系统 分 解 成 多 个 组 件 , 这 在 软件 设计 中 比 类 和 代码 的 抽象 层次 上 略 高 。 审计 组 件 可 
能 是 用 连接 了 日 志 框架 〈 比 如，log4j 、log4net 等 ) 的 某 个 类 实现 ， 但 把 它 当 作 一 个 单独 的 组 件 
来 对 待 ， 也 可 以 让 你 看 到 它 是 什么 , 它 是 你 的 架构 中 的 结构 单元 。 在 这 一 层次 工作 ,对 于 了 解 你 
的 系统 内 部 结构 是 一 个 很 好 的 方式 ,哪里 可 以 复 用 、 哪 里 有 组 件 之 间 的 依赖 、 哪 里 有 组 件 和 容器 
间 的 依赖 ,等 等 。 把 整个 问题 分 解 为 若干 个 独立 的 部 分 ， 也 为 你 开始 做 一 些 高 层次 预 估 提 供 了 基 
础 ， 如 果 你 曾经 被 要 求 对 一 个 新 项 目 做 大 概 的 预 估 ， 这 就 非常 棒 。 


组 件 图 展示 了 驻 留 在 每 个 容 右 中 的 人 逻辑 组 件 。 这 很 和 用， 因为 : 


口 展示 了 在 高 层次 上 将 你 的 软件 系统 分 解 为 职责 不 同 的 组 件 ; 
口 展示 了 组 件 之 间 的 关系 和 依赖 ; 
口 为 软件 开发 的 高 层次 预 佑 和 如 何 分 解 交付 提供 了 一 个 框架 。 


在 这 个 抽象 层次 上 设计 一 个 软件 系统 , 完全 可 以 在 数 小 时 或 数 天 内 完成 ， 而 无 需 几 周 或 几 个 
它 也 为 你 做 好 了 准备 ， 可 以 在 类 和 接口 的 层次 上 设计 /编码 而 无 需 担心 整体 高 层次 结构 。 


月 


O 


世人 入 
学 从 


口 软件 开发 团队 中 的 技术 人 员 。 


示例 
如 容器 图 所 示 ,“ 技 术 部 落 ” 包 含 一 个 从 Twitter 、GitHub 和 博客 拉 取 内 容 的 独立 进程 。 就 组 
件 而 言 ， 下 图 展示 了 内 容 更 新 器 高 层次 的 内 部 结构 。 


除了 一 些 核心 组 件 ( 见 下 ), 内 容 更 新 顺 由 四 个 组 件 组 成 : 一 个 计划 内 容 更 新 器 , 一 个 Twitter 
连接 需 , 一 个 GitHub 连接 名和 一 个 新 闻 订 阅 连接 需 。 这 张 图 展示 了 内 容 更 新 需 如 何 拆 分 为 组 件 ， 
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这 些 组 件 是 什么 ， 它们 的 职责 以 及 技术 /实现 细节 。 这 里 是 核心 组 件 。 


<< 容 器 >> << 容 器 >> << 容 器 >> 
关系 型 数据 库 文件 系统 NoSQL 数 据 存储 
MySQL 5.5.x MongoDB 2.2.x 


<< 组 件 >> 
计划 内 容 更 新 器 ，Spring 
计划 任务 ， 从 外 部 系统 出 


癌 忆 、 


<< 组 件 >> << 组 件 >> << 组 件 >> 
| Twitter 连接 器 ，Twitter4J， GitHub 连 接 器 ，Eclipse 新 闻 订阅 连接 器 ,ROME， 
| 提取 配置 信息 和 微 博 (使 用 Mylyn， 提 取 仓库 信息 从 RSS 和 Atomi 订 阅 提取 内 
REST 和 Streaming API) 容 


] | | | 
获取 数据 [HTTP] 获取 数据 [HTTP] 获取 数据 [HTTP] 
| | 


| 


-oo -eo -oo 


<< 外 部 系统 > 。。， ， < 外 部 系统 >> 。! ， < 外 部 不 统 > ! 
博 


Twitter GitHub 4 


So- 和 四 和 


“技术 部 落 ”- 组 件 -内 容 更 新 需 
独立 Java 进程 
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<< 组 件 >> 

活动 组 件 ， 
Spring Bean + 
JDBC， 提 供 
对 近期 活动 的 
评级 信息 的 访 

问 并 计算 


<< 组 件 >> << 组 件 >> << 组 件 >>> || << 组 件 >> << 组 件 >> 三 << 组 件 >> << 组 件 >> << 组 件 >> 
事件 组 件 ， 新 闻 订 阅 入 口 演讲 组 件 ， 微 博 组 件 ， 微 章 组 件 ， GitHub 组 件 ， 工作 组 件 ， 搜索 组 件 ， 
Spring Bean + | | 组 件 ，Spring Spring Bean + || Spring Bean + | | Spring Bean + | | Spring Bean + | | Spring Bean + | | Spring Bean + 
JDBC， 提 供 对 | | Bean + Mongo- | | JDBC, 提供 “| MongoDB， JDBC， 管 理 ||JDBC， 提 供 对 | JDBC， 提供 Lucene, 在 
本 地 事件 ( 比 | DB， 提供 对 博 | | 对 本 地 演讲 者 | 提供 对 微 博 的 || 已 授予 人 和 部 | | 与 内 容 源 相关 | | 对 最 近 发 布 | | 设备 中 搜索 
如 ; 聚会 、 用 | | 客 文章 和 新 闻 | | 的 演讲 信息 的 | 访问 落 的 徽章 ”| | 的 GitHub 仓 库 | 的 工作 信息 | 新 闻 订阅 入 
户 组 等 ) 信息 的 访问 访问 清单 的 访问 的 访问 口 和 微 博 


使 用 
<< 组 件 >> 

内 容 尖 组 件 内 容 源 组 件 ， 
Spring Bean + Spring Bean + 
JDBC， 提 供 JDBC， 提供 
对 人 和 部 落 的 对 人 和 部 落 的 

信息 的 访问 信息 的 访问 

| 沽 被 所 有 组 件 使 用 \ | 


1 “技术 部 落 ” 核 心 组 件 (techtribes-core.jar) 


第 9 章 
是 否 包 含 技术 选择 


回想 你 最 近 一 次 看 到 的 软件 架构 图 。 它 看 起 来 像 什 么 ,展示 了 哪个 层次 的 细节 ，, 是否 包 含 了 
技术 选择 ? 根据 我 的 经 验 , 大 部 分 架构 图 都 忽略 了 任何 有 关 技 术 的 信息 ,而 是 专注 于 说 明 功 能 分 
解 和 主要 概念 元 素 。 这 是 为 什么 ? 


在 设计 过 程 中 绘图 


绘制 软件 架构 图 的 主要 原因 之 一 是 在 软件 设计 过 程 中 交流 思想 , 就 像 你 会 在 建筑 项 目前 期 看 
到 草拟 的 蓝图 。 


在 我 定期 举办 的 训练 班 上 , 我 会 要 求 各 个 小 组 设计 一 个 简单 的 金融 风险 系统 , 这 是 其 中 一 答 
课 上 完成 的 一 张 架 构图 的 照片 。 除 了 解决 方案 ,这 张 图 本 身 在 我 所 见 中 也 相当 典型 ， 它 展示 了 一 


个 概念 性 设计 而 不 是 技术 细节 。 
间 人 们 为 什么 他 们 的 图 不 展示 任何 技术 决策 ， 得 到 的 反应 多 种 多 样 

口 “[ 金 融 风险 系统 ] 的 解决 方案 很 简单 ， 可 以 用 任何 技术 构建 ”; 

口 “ 我 们 不 想 把 一 种 解决 方案 强加 给 开发 者 ”; 

口 “ 这 属于 实现 细节 ”; 

口 “ 我 们 遵循 “最 后 责任 时 刻 ” 原 则 ”。 
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回顾 性 绘图 


如 果 你 是 在 软件 构建 完成 之 后 , 为 了 编写 文档 而 回顾 性 地 绘制 软件 架构 图 , 那 就 真 的 没有 理 
由 忽略 技术 决策 。 然 而 ， 其 他 人 不 见得 同意 这 种 观点 ， 我 经 常 听 到 如 下 评论 : 
口 “ 技 术 决 策 会 把 图 搞 乱 ”; 
口 “ 但 是 每 个 人 都 知道 我 们 只 使 用 ASPNET 操作 Oracle 数据 库 ”。 


架构 图 应 该 概念 化 


无 论 是 在 软件 构建 之 前 、 过 程 中 还 是 之 后 画图 , 似乎 都 有 一 个 普遍 的 误解 ,架构 图 本 质 上 应 
该 概念 化 。 

软件 架构 名 声 不 好 的 一 个 原因 是 因为 闭门造车 的 架构 师 绘制 非常 高 层次 的 图 像 来 描述 他 们 
宏伟 愿景 造成 的 刻板 印象 。 我 相信 你 也 见 过 这 样 的 例子 : 有 一 个 标 有 “企业 服务 总 线 ” 的 大 框 ， 
连接 到 云端 ; 或 者 可 能 展示 了 功能 分 解 , 却 明显 没有 考虑 愿景 是 否 能 够 实现 。 如 果 你 真 的 认为 软 
件 架 构图 本 质 上 应 该 是 肤浅 和 概念 化 的 , 那 我 的 建议 是 雇用 不 懂 技 术 的 人 ,应 该 能 解决 你 的 问题 。 

回 到 真实 世界 ， 我 喜欢 看 到 脚踏实地 的 软件 架构 ,技术 选择 不 应 该 是 实现 细节 。 确 保 技术 得 
到 考虑 的 一 个 方法 就 是 将 技术 选择 展示 在 软件 架构 图 中 。 


明确 技术 选择 


哪怕 你 在 一 个 所 有 软件 都 用 一 套 标准 的 技术 和 模式 构建 的 环境 中 工作 , 在 软件 架构 图 中 包括 
技术 选择 都 可 以 消除 收 义 。 想象 你 在 设计 一 个 软件 系统 。 你 真 的 不 思考 到 底 要 如 何 实 现 它 ? 你 真 
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的 是 根据 概念 化 的 框 和 功能 分 解 来 思考 ? 如 果 这 些 问 题 的 答案 是 “不 ”， 那 么 为 什么 不 在 图 上 增 
加 这 个 额外 的 信息 层 。 这 样 做 为 对 话 提供 了 一 个 更 好 的 起 点 ,特别 当 你 有 一 个 可 用 的 技术 选择 时 。 
强迫 人 们 在 他 们 的 软件 架构 图 中 包括 技术 选择 往往 还 能 引发 更 丰富 、 深 入 、 脚 蹄 实地 的 交流 。 一 
个 肤浅 和 概念 化 的 图 往往 会 造成 许多 假设 ， 但 分 解 技术 使 我 们 不 得 不 问 下 面 这 类 问题 : 


中 ， 


口 
口 
口 
口 


“这 个 组 件 如 何 与 运行 在 单独 进程 中 的 男 一 个 组 件 沟通 ?” 
“这 个 组 件 如 何 初始 化 ， 职 责 又 是 什么 ? ” 

“为 什么 这 个 进程 需要 和 另 一 个 进程 沟通 ? ” 

“为 什么 这 个 组 件 要 用 技术 而 不 是 立 技 术 实现 ? “ 


口 其 他 。 39 


至 于 技术 决策 把 图 搞 乱 的 问题 , 有 多 种 处 理 策略 ,包括 使 用 容器 图 来 单独 展示 主要 技术 决策 。 


在 交流 大 局 的 整体 而 不 只 是 其 中 一 部 分 时 , 技术 选择 有 助 于 把 其 他 理想 化 和 概念 化 的 软件 设 
计 带 回 现 实 ， 再 次 脚踏实地 。 当 然 ， 把 技术 选择 加 入 图 中 的 其 他 副作用 ,特别 是 在 软件 设计 过 程 
就 是 它 有 助 于 确保 让 合适 的 人 来 画图 。 


第 勾 人 CI 阐 
你 会 那 梓 编 反 吗 


有 一 个 普遍 的 误解 : 软件 架构 图 需要 被 困 在 云 里， 展现 逻辑 上 高 层次 的 概念 和 表达 ， 而 不 是 
物理 的 抽象 。 但 它 不 应 该 是 这 样 的 ， 把 它们 带 回 到 现实 往往 让 图 变 得 更 容易 解释 和 理解 ,也 让 图 
更 好 画 。 


为 了 说 明 为 什么 思考 实现 有 助 于 绘图 ， 这 里 有 一 些 我 在 培训 班 上 经 常 遇 到 的 场景 。 


共享 组 件 


想象 你 利用 一 个 Web 服务 器 、 一 个 应 用 程序 服务 器 和 一 个 数据 库 设 计 来 设计 一 个 三 层 的 软 
件 系统 。 在 思考 驻 留 在 这 些 容器 中 的 高 层次 组 件 时 ， 听 到 这 样 的 对 话 并 不 罕见 。 


口 参与 者 :“ 既 然 Web 服务 器 和 应 用 程序 服务 器 都 在 使 用 日 志 组 件 , 我 们 应 该 把 它 画 在 这 两 
者 之 外 吗 ? ” 
我 :“ 你 会 那样 编写 代码 吗 ? 日 志 组 件 会 在 Web 服务 器 和 应 用 程序 服务 器 之 外 运行 吗 ? 
比如 说 ， 它 真 的 是 一 个 单独 的 进程 吗 ? ” 
口 参与 者 :“ 好 吧 …… 不 是 ， 它 很 可 能 是 我 们 会 同时 部 署 到 两 个 服务 器 上 的 [JAR 文件 IDLL| 
其 他 ] 中 的 一 个 共享 组 件 。” 
口 我 :“ 好 ， 那 么 让 我 们 也 这 样 画图 。 在 每 个 服务 器 中 都 包含 日 志 组 件 ， 用 一 个 注释 、 定 型 
或 符号 把 它 标 为 共享 组 件 。 

如 果 你 要 实现 部 署 到 多 个 不 同 服务 器 的 共享 日 志 组 件 之 类 的 东西 ， 确 保 你 的 图 反映 出 这 一 
点 ， 而 不 是 包含 一 些 可 能 被 误 认 为 是 单独 的 中 心 化 日 志 服 务 器 的 东西 来 误导 人 们 。 如 果 有 疑问 ， 
问 问 自己 你 会 如 何 编写 代码 。 


0 
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分 层 策 略 
想象 你 在 设计 一 个 内 部 可 分 为 用 户 界 面 层 设计 、 服 务 层 和 数据 访问 层 的 Web 应 用 程序 。 


口 参与 者 :“ 我 们 应 该 展示 所 有 用 户 界面 与 数据 库 的 沟通 都 要 通过 服务 层 吗 ?” 
口 我 :“ 这 是 你 打算 实现 的 方式 吗 ? 或 者 用 户 界面 会 直接 访问 数据 库 吗 ? ” 


口 参与 者 :“ 我 们 在 考虑 可 能 要 采用 CQRS 模式 , 这 样 用 户 界面 可 以 绕 过 服务 层 , 直接 使 用 
数据 访问 层 。” 


口 我 :“ 在 这 种 情况 下 ， 像 你 刚才 解释 的 那样 画图 ， 从 用 户 界 面 的 服务 和 数据 访问 层 都 画 出 
线 。 给 线 标注 意图 和 理由 。 


再 说 一 次 ， 要 回答 这 类 问题 ， 最 简单 的 方式 就 是 搞 明 白 你 要 如 何 编写 代码 。 


图 应 该 反映 现实 


如 果 你 以 画图 来 回顾 性 地 交流 软件 系统 ， 那 么 问题 就 变 成 了 “我 们 会 这 样 编写 代码 吗 ”。 然 
而 ， 原 则 是 相同 的 。 图 应 该 表达 反映 现实 的 抽象 ， 而 不 是 对 不 存在 的 进行 概念 化 表现 。 你 应 该 能 
看 到 图 的 元 素 反 映 在 代码 库 中 , 反之 亦 然 。 如 果 你 能 明白 自己 要 如 何 编写 代码 ， 就 能 知道 如 何 可 
视 化 。 


WY http://martinfowler.com/bliki/CQRS.html 


第 勾 7 章 
软件 架构 和 编 反 


尽管 有 很 多 软件 团队 都 发 现 可 视 化 他 们 的 软件 系统 的 架构 很 坏 手 , 还 是 让 我 们 假设 情况 并 非 
如 此 ,你 在 为 一 些 想 法 绘制 草图 , 这 些 想 法 跟 你 负责 构建 的 新 系统 的 软件 架构 有 关 。 对 于 恰 如 其 
分 的 软件 架构 ， 一 个 重要 方面 是 理解 软件 系统 的 重要 元 素 如 何 结合 在 一 起 。 


职责 驱动 设计 和 组 件 分 解 


对 我 来 说 , 这 意味 着 深入 组 件 、 服 务 或 模块 的 层次 ,它们 各 自 都 有 一 组 特定 的 职责 。 值得 强 
调 的 是 ， 这 不 是 理解 底层 实现 细节 ， 而 是 进行 初步 的 分 解 。 基 于 组 件 开发 的 维基 百科 页 面 "/ 有 一 
个 很 好 的 总 结 ,“ 组 件 ” 可 能 是 像 风险 计算 器 、 审 计 记 录 器 、 报 表 生 成 器 、 数 据 导入 器 等 一 样 的 
东西 。 考 虑 一 个 组 件 最 简单 的 方式 就 是 ， 它 是 接口 背后 的 一 组 相关 行为 ,可 以 用 一 个 或 多 个 协作 
类 实现 ( 当然 , 假设 是 面向 对 象 的 语言 )。 好 的 组 件 和 好 的 类 有 一 些 共性 ， 应 该 高 内 聚 、 低 耦合 ， 
有 良好 定义 的 公共 接口 、 良 好 的 封 、 装 等 。 


根据 组 件 来 考虑 一 个 软件 系统 有 很 多 好 处 , 但 本 质 上 它 让 我 们 可 以 把 软件 看 作 少数 高 层次 的 
抽象 ,而 不 是 组 成 大 多 数 企业 系统 中 成 百 上 千 个 类 , 来 考虑 和 谈论 。 下 面 的 照片 展示 了 在 我 们 举 
办 的 培训 班 上 产生 的 一 张 典 型 的 组 件 图 。 各 组 都 要 设计 一 个 简单 的 金融 风险 系统 , 该 系统 需要 拉 
取 一 些 数据 ， 执 行 一 些 计算 ， 并 生成 一 个 Excel 报表 作为 输出 。 

这 张 草 图 包含 了 你 期 望 在 一 个 导入 数据 、 执 行 风险 计算 和 生成 报表 的 系统 中 看 到 的 主要 组 件 。 
这 些 组 件 为 我 们 提供 了 一 个 区 分 我 们 系统 内 部 行为 的 框架 , 这 样 在 其 中 跟踪 主要 用 例 / 用 户 故 事 就 应 
该 相对 容易 。 这 是 软件 开发 过 程 中 一 个 非常 有 用 的 起 点 , 有 助 于 建立 团队 能 够 为 之 努力 的 共同 愿景 。 


GD http:/en.wikipedia.org/wiki/Component-based_software_engineering 
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我 们 往往 以 组 件 为 单位 来 思考 
但 这 同时 也 非常 危险 。 没 有 技术 选择 ( 或 选项 )， 这 张 图 看 起 来 就 像 那 种 闭门造车 的 架构 师 
的 作品 , 对 很 多 拥有 技术 背景 的 人 来 说 , 它 显得 非常 “概念 化 ”( 或 者 “肤浅 ”, 取决 于 你 的 观点 )。 


我 们 谈论 组 件 但 编写 类 


人 们 一 般 都 理解 把 软件 当 作 少量 高 层次 结构 单元 来 考虑 的 益处 。 毕 竟 ， 


这 是 在 一 个 软件 系统 


中 划分 职责 的 好 方法 , 当 人 们 讨论 架构 时 , 你 会 经 常 听 到 他 们 谈论 组 件 。 这 就 是 基于 组 件 的 开发 ”， 
尽管 很 多 人 以 组 件 来 谈论 他 们 的 软件 系统 ， 然 而 代码 通常 并 未 反映 出 这 种 结构 。 这 就 是 软件 架构 


和 依据 原则 编码 之 间 会 脱节 的 原因 之 一 : 


当 你 打开 一 个 代码 库 ， 由 于 代码 的 组 织 ， 


墙 上 的 架构 图 说 的 是 一 回 事 ， 代 码 说 的 却 是 另 一 回 事 。 
它 往 往 会 反映 出 另外 的 结构 。 软 件 系统 的 架构 视图 


和 代码 之 间 的 映射 往往 有 巨大 差异 。 这 前 


是 为 什么 有 时 候 你 会 看 到 人 们 忽视 架构 图 (或 文档 )， 


说 “代码 是 唯一 的 真相 ”。 乔 治 . 菲 尔 班 克 # 


( George Fairbanks ) 在 《恰如其分 的 软件 架构 ， 风 


险 驱 动 的 设计 方法 》( Just Enough Softrware Architecture ) “一 书 中 称 之 为 “模范 代码 的 差距 ”。 代 
人 码 库 的 组 织 真 的 能 帮助 或 阻碍 对 架构 的 理解 。 


用 层 封 泌 代 码 


很 多 软件 团队 用 分 层 来 结构 化 他 们 的 代码 。 换 句 话说， 如 果 你 打开 一 个 代码 库 ， 就 会 看 到 域 
类 包 、UI 素 材 包 、 "业务 服务 ” 包 、 数 据 访 问 包 、 集 成 包 等 。 这 里 我 用 了 “ 包 ” 这 个 Java 术 语 ， 


但 同样 适用 于 C# 的 命名 空间 ， 等 等 。 


原因 很 简单 。 我 们 知道 ， 架 构 分 层 一 般 都 是 “好 事 ”， 很 多 教程 都 把 这 种 封装 风格 作为 结 松 


GD http://en.wikipedia.org/wiki/Component-based software_engineering 
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化 代码 的 方法 来 教授 。 举 个 例子 ， 如果 你 用 谷歌 搜索 Spring 或 ASPNET MVC 的 相关 教程 ， 就 会 
在 示例 代码 中 看 到 这 一 点 。 我 的 职业 生涯 大 都 花 在 用 Java 构建 软件 系统 上 ， 在 参与 过 的 大 多 数 
项 目 中 ， 我 也 用 同样 的 封装 方法 。 


这 种 封装 代码 的 方法 尽管 没有 什么 错 , 代码 结构 却 从 未 反映 出 我 们 从 架构 角度 看 这 个 系统 时 
考虑 的 抽象 。 如 果 使 用 一 种 面向 对 象 的 编程 语言 ， 你 在 讨论 架构 时 会 谈论 “对 象 ” 吗 ? 以 我 的 经 
验 来 看 ,答案 是 否定 的 。 我 听 到 的 往往 是 组 件 和 服务 之 类 的 概念 ， 结 果 架 构图 中 的 “组 件 ” 实 际 
上 是 由 多 个 层 上 的 类 组 合 实现 的 。 比 如 ， 你 可 能 会 发 现 一 个 组 件 有 一 部 分 在 “服务 ” 包 里 ， 其 他 
部 分 则 在 “数据 访问 ” 包 里 。 


为 了 做 到 这 一 点 ， 较 底层 的 代码 ( 比如 “数据 访问 ” 包 ) 往往 是 公开 可 见 的 ， 这 意味 着 它 也 
能 被 架构 中 的 其 他 层 直 接 调 用 。 


je.techtribes.service 


<< 接 口 >> 
TweetService 


人 


DefaultTweetService 
T 


<< 使 用 >> 


一 个 组 件 往往 是 不 同 
层 上 的 多 个 类 的 组 合 


TweetDao 


en 


MongoDBTweetDao 


1 

1 

| 

| 1 

<< 接 口 >> | 
1 

1 

1 

| 


je.techtribes.data 


用 特性 封 溢 


然而 用 层 封装 并 不 是 唯一 的 答案 ， 马 克 … 尼 达 姆 ( Mark Needham ) 有 一 篇 非常 好 的 博文 
“Coding: Packaging by vertical slice”"， 讲 到 了 一 种 基于 功能 的 垂直 切片 来 组 织 代 码 的 方法 。 用 
谷歌 搜索 “以 特性 封装 和 以 层 封 装 ””， 会 得 到 很 多 有 关 这 个 话题 的 讨论 。 


GD http://www.markhneedham.com/blog/2012/02/20/coding-packaging-by-vertical-slice/ 
© https://www.google.comy/search?q=package+by+feature+vs+package+by+layer 
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用 组 件 封装 


用 层 来 组 织 代码 库 使 得 软件 的 整体 结构 更 易 观 察 , 但 这 也 有 取舍 。 举 个 例子 ,为 了 改变 特性 
或 用 户 故 事 ， 你 需要 深入 多 个 层 (比如 包 、 命 名 空间 等 ) 探究 。 同 时 ， 考 虑 到 企业 系统 内 有 相当 
标准 的 分 层 方法 ,很 多 代码 库 最 后 看 起 来 都 惊人 地 相似 。 


鲍 勃 .马丁 大 叔 在 Screaming Architecture 中 说 ， 如 果 你 正在 看 一 个 代码 库 ， 它 应 该 喊 出 跟 
业务 领域 相关 的 东西 。 以 特性 而 不 是 分 层 来 组 织 代码 能 够 做 到 这 一 点 , 但 同样 有 取舍 。 我 喜欢 一 
点 细微 的 变化 ， 就 是 明确 地 以 组 件 来 组 织 代码 。 举 个 例子 ， 如 果 你 去 GitHub 看 看 je.techtribes. 
component.tweet 这 个 包 ”， 就 会 发 现 它 看 起 来 像 这 样 。 


je.techtribes.component.tweet 


<< 接 口 >> 
TweetComponent 


TweetComponentimpl 


1 
<< 使 用 >> 
1 


Vy 


MongoDBTweetDao 
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这 很 像 以 特性 来 封装 ,但 它 更 类 似 于 马克 尼 达 姆 在 博文 "中 谈 到 的 “微服 务 ”。 je.techtribes. 
component 的 每 个 子 包 都 安置 了 一 个 单独 的 组 件 ， 具 有 自己 内 部 的 层 和 配置 。 只 要 可 能 ， 其 内 部 
的 作用 域 都 在 包 内 。 每 个 组 件 都 可 以 拿 出 来 ， 放 进 它 自 己 的 项 目 或 源 代 码 仓库 ， 分 别 控制 版 本 。 
如 果 你 在 构建 有 非常 明确 的 松 看 合 架 构 的 东西 ， 比 如 由 松 看 合 组 件 组 成 的 分 布 式 消息 系统 , 可 能 
会 对 这 种 方法 感到 很 熟悉 。 

尽管 大 多 数 人 以 组 件 为 单位 考虑 他 们 的 系统 , 然而 他 们 构建 的 东西 本 质 上 还 是 更 整体 化 , 对 
此 我 相当 有 信心 。 过 去 我 当然 也 用 类 似 方法 封装 过 整体 化 代码 库 的 一 部 分 , 但 这 往往 是 相当 专门 
化 的 。 老 实说 ， 以 包 来 组 织 代码 并 不 怎么 费 脑 子 ， 特别 是 考虑 到 我 们 所 掌握 的 重 构 工 具 。 以 组 件 


GD http://blog. 8thlight.com/uncle-bob/2011/09/30/Screaming-Architecture.html 

© https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/tweet 
©® http:/www.markhneedham.com/blog/2012/02/20/coding-packaging-by-vertical-slice/ 

(@ https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component 
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来 组 织 代 码 让 你 可 以 从 架构 到 代码 库 明 确 地 反映 “组 件 ” 的 概念 。 如 果 你 的 软件 架构 图 喊 出 了 跟 
业务 领域 相关 的 东西 (也 应 如 此 )， 这 也 会 反映 在 你 的 代码 库 里 。 


对 齐 软件 架构 和 代码 


软件 架构 和 编码 常常 被 视 为 相互 排斥 的 原则 , 架构 和 代码 之 间 相 互 的 映射 往往 非常 少 。 对 软 
件 架 构 有 效 和 高 效 地 可 视 化 有 助 于 在 团队 内 创造 一 个 良好 的 共同 愿景 , 让 项 目 进行 得 更 快 。 从 架 
构 到 代码 有 一 个 简单 而 明确 的 映射 还 有 进一步 的 作用 , 特别 是 当 你 开始 观察 协同 设计 和 集体 代码 
所 有 制 。 此 外 , 这 还 有 助 于 把 软件 架构 坚决 地 带 回 到 开发 团队 的 领域 , 也 就 是 它 最 终 所属 的 地 方 。 
但 不 要 忘 了 ,你 所 用 的 架构 风格 需要 反映 在 软件 架构 图 中 ,不 管 是 层 、 组 件 、 微 观 服 务 或 者 别 的 
什么 东西 。 


围绕 组 件 设 计 一 个 软件 系统 并 不 是 “唯一 正确 的 方式 ”, 但 如 果 你 在 构建 整体 化 的 软件 系统 ， 
并 认为 它们 是 由 一 些 更 小 的 组 件 组 成 , 那 就 确保 你 的 代码 库 反 映 出 这 一 点 。 考 虑 以 组 件 ( 而 不 是 
层 或 特性 ) 来 组 织 你 的 代码 ， 证 软件 架构 和 代码 之 间 的 映射 更 明确 。 如 果 解 释 你 的 软件 系统 结构 
很 困难 ， 那 就 改变 它 。 


第 承 少 章 
你 不 需要 UML 工 具 


当 负 责 一 个 新 软件 系统 的 设计 工作 时 ,一些 人 首先 会 提出 的 问题 之 一 就 跟 他 们 应 该 使 用 的 工 
具有 关 。 这 样 的 讨论 通常 会 重点 围绕 着 统一 建 模 语言 (UML )， 以 及 他 们 的 组 织 是 否 有 任何 比较 
知名 的 UML 工具 的 许可 证 。 


有 很 多 类 型 的 UML 工 具 


不 地 的 是 , 这 个 问题 并 不 容易 回答 , 因为 有 很 多 商业 和 开源 的 工具 可 以 帮助 你 进行 软件 架构 
和 设计 ， 这 些 工具 往往 会 从 不 同 的 角度 来 处 理 这 个 问题 。 它 们 可 以 从 较 高 层次 归纳 如 下 。 


(1) 只 有 图 : 有 很 多 独立 的 UML 工具 和 针对 主流 IDE" 的 插件 ， 可 以 让 你 画 简单 的 UML 图 。 
它们 对 控制 你 的 图 和 图 描述 的 内 容 真 的 很 有 用 ， 但 这 样 的 图 也 很 容易 随 着 时 间 推 移 而 落后 于 现 
实 。 如 果 你 有 使 用 权 ， 那 么 安装 了 UML 模板 的 微软 Visio 或 OmniGraffle 都 是 很 好 的 起 点 。 

(2) 逆向 工程 有 独立 的 UML 工具 和 IDE 插件 可 以 从 代码 创建 UML 图 。 这 非常 好 ， 因 为 你 
可 以 快速 同步 代码 和 图 表 , 但 这 些 图 表 往 往 也 会 很 快 变 得 杂乱 ， 因 为 它们 通常 默认 包含 了 所 有 细 
节 ( 比如， 每 一 个 属性 、 方 法 和 关系 )。 

(3) 往返 工程 : 许多 逆向 工程 工具 还 允许 你 做 往返 工程 ， 对 模型 所 做 的 改变 会 反映 在 代码 中 ， 
反之 亦 然 。 这 有 助 于 保持 代码 和 图 同步 。 

(4) 模型 驱动 : 有 几 个 模型 驱动 架构 (MDA ) 的 工具 ， 可 以 让 你 从 模型 自身 驱动 软件 系统 的 
实现 ， 通 常 是 通过 在 图 上 用 可 执行 UML (xUML ) 或 对 象 约束 语言 (OCL ) 之 类 的 语言 标注 出 
所 需 特 性 和 行为 。 这 些 工 具 可 以 提供 一 个 完整 的 端 到 端的 解决 方案 , 但 为 了 从 中 受益 ,你 需要 遵 
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循 一 个 不 一 样 并 且 往 往 是 刚性 的 开发 过 程 。 


既 有 效 又 简单 


即使 对 可 用 工具 分 类 的 简短 总 结 ， 也 会 带 来 数量 巨大 的 选择 。Rational 软件 架构 师 ? Visio? 
PowerPoint? OmniGraffle? WebSequenceDiagrams.com? 你 选择 哪 一 个 ?! 


然而 关键 在 于 ， 架 构 和 设计 软件 并 不 需要 UML 工具 。 在 过 去 几 年 的 大 会 演讲 中 ， 我 做 了 一 
些 非 正式 的 调查 ， 只 有 10%~20% 的 听众 说 他 们 在 日 常 工作 中 经 常 使 用 UML。 一 张 白 纸 、 挂 图 或 
白板 ， 以 及 一 套 便利 贴 或 索引 卡 ， 你 需要 的 通常 就 是 这 些 ， 特别 是 当 你 有 一 组 人 想 要 以 协作 的 方 
式 承 担 设计 过 程 。 你 有 没有 试 过 三 四 个 人 挤 在 笔记 本 电脑 屏幕 前 协作 ? 


敏捷 方法 将 这 种 技术 含量 不 高 的 方法 用 于 捕捉 用 户 故 事 、 故 事 墙 和 看 板 已 经 有 一 阵子 了 。 在 
许多 情况 下 ,这 是 能 够 奏效 的 最 简单 的 方法 , 但 什么 都 抵 不 过 办 公 室 中 间 人 人 都 能 看 到 的 、 贴 满 
了 东西 的 白板 。 跟 微软 项 目 计 划 不 同 , 没 人 能 忍 住 不 走 过 去 瞧 瞧 那些 仍 在 “ 待 办 ”一 栏 的 便利 巾 。 


从 软件 设计 的 角度 来 看 , 使 用 技术 含量 不 高 的 方法 ,可 以 把 你 从 对 使 用 工具 的 复杂 性 的 担忧 
和 对 正式 标记 法 的 届 从 中 解放 出 来 , 从 而 能 集中 精力 在 软件 设计 的 创造 性 工作 上 。 就 以 勾画 出 大 
局 为 起 点 ,加 工 必要 的 底层 细节 。 记 住 ， 如 果 你 不 使 用 工具 ， 就 需要 明确 地 思考 各 个 抽象 层次 之 
间 的 可 追溯 性 、 规 约 和 一 致 性 。 比 如 ，UML 的 箭头 是 有 意义 的 ， 缺 了 线索 ， 你 随手 画 的 箭头 到 
底 是 指向 依赖 还 是 指示 数据 的 流向 ， 可 能 就 不 明显 。 如 果 过 后 需要 的 话 ， 你 总 是 可 以 用 UML 工 
有 具 以 更 加 正式 的 方式 记录 你 的 设计 。 


UML 的 用 途 


在 我 看 来 ， 使 用 非 正 式 的 框 线 图 而 不 是 UML 来 可 视 化 软件 架构 的 主要 原因 是 ， 对 于 我 想 传 
达 的 东西 ，UML 往往 不 是 一 个 合适 的 选择 。 我 的 语 境 图 、 容 器 图 和 组 件 图 呈现 的 信息 可 以 通过 
用 例 、 组 件 和 部 署 图 的 混合 使 用 获得 ， 但 我 个 人 不 觉得 得 到 的 图 很 容易 用 标记 法 解释 。UML 对 
我 的 可 视 化 软件 架构 的 C4 方 法 可 能 就 没 用 ， 但 我 仍然 将 其 用 在 我 工作 的 软件 项 目 上 。 


UML 周边 的 工具 使 它 可 以 被 用 在 许多 方面 ， 包 括 带 有 关联 仓库 的 全 面 综合 模型 ， 到 从 现 有 
代码 反 向 工程 得 到 的 图 表 。UML 也 可 以 用 作 简 单 的 图 表 标 记 法 ， 要 么 在 白板 上 画 草 图 ， 要 么 在 
微软 Visio 或 OmniGraffle 之 类 具有 可 安装 的 UML 模板 的 工具 中 ,这 里 是 我 对 UML 用 途 的 总 结 。 


口 流程 和 工作 流 : 如 果 要 构建 一 个 流程 自动 化 或 是 基于 工作 流 的 软件 ， 我 往往 绘画 一 张 简 
单 的 UML 活动 图 来 表示 。 很 多 人 似乎 忽略 了 UML 活动 图 ， 但 是 我 发 现 简单 的 流程 图 式 
的 标记 法 适用 范围 非常 广 。 

口 运行 时 行为 : 我 的 C4 方法 真 的 只 关注 可 视 化 软件 系统 的 静态 结构 , 但 从 运行 时 的 角度 来 
呈现 系统 往往 是 有 用 的 。UML 序列 和 协作 图 通常 用 于 展示 多 个 类 在 运行 时 协作 实现 一 个 
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特定 的 用 户 故 事 、 用 例 、 特 性 等 。 即 使 你 的 设计 没有 做 到 类 这 个 级 别 ， 这 些 图 表 仍 然 非 
常 有 用 。 你 可 以 展示 协作 容器 或 组 件 ， 而 不 是 展示 一 系列 协作 类 。 

口 域 模 型 : 如 果 想 可 视 化 一 个 域 模 型 ， 我 会 使 用 UML 类 图 ,得 到 的 图 通常 只 展示 最 重要 的 

属性 和 关系 。 通 常 在 这 种 图 上 我 会 隐藏 所 有 类 的 方法 分 隔 。 

口 模式 和 原则 : 我 经 常 需要 解释 如 何在 代码 库 中 实现 模式 或 原则 (〈 比如 一 本 软件 指南 的 代 
码 部 分 )，UML 类 网 显然 是 做 这 件 事 的 方法 。 我 的 建议 是 让 图 保持 简单 ,不 要 因 感 到 有 压 
力 而 展示 每 一 个 微小 细节 。 

口 状态 图 表 : UML 状态 图 是 可 视 化 状态 机 的 好 方法 ,标记 法 也 相当 直接 。 我 发 现 人 们 总 是 

忘记 UML 状态 图 的 存在 。 

口 部 署 : 要 展示 你 的 容器 或 组 件 是 如 何 部 署 的 ，UML 部 署 图 是 一 个 很 有 用 的 方法 。 通 常 这 
种 图 呈现 为 非 正 式 的 框 线 图 比较 好 ， 但 决定 权 在 你 。 


没有 银 弹 


忘 了 昂贵 的 工具 吧 。 很 多 时 候 , 你 需要 的 只 是 一 张 白 纸 、 挂 图 或 白板 , 特别 是 当 你 有 一 组 人 
想 要 以 协作 的 方式 承担 设计 过 程 。 然 而 不 幸 的 是 , 当 谈 到 设计 工具 时 , 并 没有 银 弹 , 因为 每 个 人 、 2 
每 个 组 织 的 工作 方式 都 不 同 。 一 旦 你 确信 自己 明白 了 如 何 进行 软件 的 架构 和 设计 , 才 是 时 候 开始 
研究 软件 工具 来 帮助 改进 设计 流程 。 


是 否 使 用 UML 并 不 是 一 个 黑白 分 明 的 选择 。 几 张 到 位 的 UML 图 真 的 可 以 帮助 你 呈现 一 个 
软件 系统 中 复杂 和 详细 的 元 素 。 如 果 你 不 熟悉 UML ， 也 许 现在 就 是 让 你 意识 到 有 很 多 可 用 图 表 
的 好 机 会 。 你 不 需要 UML 工具 来 做 架构 和 设计 ， 但 它们 确 有 自己 的 用 途 。 你 不 需要 把 每 种 类 型 
的 图 表 全 都 用 上 ! 


第 炙 . 刀 阐 
有 效 的 草图 


统一 建 模 语言 (UML ) 是 正规 且 标 准 化 的 交流 软件 系统 设计 的 标记 法 ， 尽 管 很 多 人 更 推崇 
框 线 式 草 图 。 这样 当 然 没 有 错 , 但 你 为 了 图 表 的 灵活 性 而 牺牲 一 致 性 , 结果 就 是 这 些 非 正规 的 草 
图 大 多 使 用 的 图 表 元 素 都 不 一 致 ， 往 往 需要 伴 以 叙述 。 


当 你 在 白板 上 画 草 图 时 ， 如果 要 使 用 “无 UML” 的 图 并 决定 以 后 用 微软 Visio 之 类 的 东西 对 
其 正规 化 ， 这 里 有 几 件 事情 要 考虑 。 


标题 


首先 ， 真正 能 帮助 人 们 理解 一 张 图 的 事 是 包含 一 个 标题 。 如 果 你 使 用 UML， 根据 图 表 的 语 
境 ， 图 表 元 素 会 提供 一 些 信息 , 但 如 果 你 的 图 表 里 都 是 框 和 线 ， 这 就 不 见得 有 帮助 。 让 标题 尽量 
短 而 有 意义 。 如 果 一 张 图 应 该 按 特定 的 顺序 来 阅读 ， 就 用 编号 来 确保 顺序 。 


标签 


你 的 图 可 能 有 多 个 标签 ， 包 括 软件 系统 的 名 称 、 组 件 等 。 如 果 可 能 ， 避 免 使 用 缩 略 词 ， 如 果 
为 了 简洁 确实 需要 使 用 缩 略 词 ， 确 保 把 它们 记录 在 项 目 词汇 表 中 或 在 图 上 某 处 留 下 图 例 。 项 目 
队 正 式 成 员 对 常见 的 项 目 缩 略 词 可 能 有 共同 的 理解 , 而 团队 外 的 人 或 项 目的 新 人 则 很 可 能 不 明白 。 


用 来 描述 技术 选择 的 缩 略 词 在 这 里 是 例外 , 特别 是 如 果 它 们 在 行业 内 被 广泛 使 用 。 例 子 包 括 
JMS (Java 消息 服务 )、POJO ( 普通 Java 对象 ) 和 WCF ( Windows 通信 基础 )。 让 特定 的 语 境 来 
决定 是 否 需要 解释 这 些 缩 略 词 ， 如 果 有 疑问 ， 安 全 起 见 可 以 使 用 全 称 或 包含 一 条 图 例 。 
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形状 


我 见 过 的 大 多 数 框 线 式 草图 都 不 仅仅 是 框 和 线 , 这 些 团 队 使 用 各 种 形状 来 表达 它们 软件 架构 
中 的 元 素 。 比 如 ， 你 经 常会 在 一 张 图 中 看 到 圆柱 ,很 多 人 会 把 它们 理解 为 某 种 类 型 的 数据 库 。 确 
保 给 出 解释 来 确认 是 否 是 这 种 情况 。 


职 


瀑 


向 架构 图 增加 一 个 额外 的 信息 层 有 一 个 很 简单 的 方法 , 就 是 对 系统 和 组 件 之 类 的 东西 , 通过 
短小 的 声明 标注 其 职责 。 项 目 符号 列表 (7+2 项 ”) 或 短 句 很 管用 。 提供 这 个 信息 时 保持 简短 (这 
个 信息 使 用 更 小 的 字体 也 很 有 帮助 )， 在 图 上 增加 职责 有 助 于 对 软件 系统 做 什么 以 及 如 何 结 构 化 
提供 真正 有 用 的 “一 目 了 然 ” 的 视角 。 


线条 是 大 多 数 架 构 草 图 的 重要 组 成 部 分 ,扮演 着 将 所 有 框 ( 系统 、 容 器 、 组 件 等 ) 连接 起 来 
的 粘 合 剂 。 而 这 正 是 线条 的 大 问题 ,它们 往往 被 认为 是 用 来 连接 图 上 其 他 更 重要 的 元 素 ,， 自己 并 
不 会 得 到 太 多 关注 。 每 当 在 草图 上 画 线 时 ， 确 保 你 的 用 法 一 致 ， 并 且 目 的 明确 ， 比 如 下 面 这 些 。 


口 线条 样式 〈 实 线 、 点 线 、 虚 线 等 ): 线条 的 样式 有 意义 吗 ? 如 果 有 ， 意 义 是 什么 ? 

口 箭头 : 箭头 是 否 指向 依赖 (比如: 像 UML 的 “用 途 ”关系 ) 或 者 表明 数据 正常 的 流向 ? 
通常 线条 上 的 标注 ( 比如 “用 途 ”、“ 发 送 数 据 *"、“ 下 载 报告 ”等 ) 有 助 于 说 明 箭 头 所 指 的 方 

向 ， 但 要 注意 两 端 都 有 箭头 的 线条 ! 


颜色 


软件 架构 图 不 一 定 是 黑白 的 。 颜色 可 以 用 来 区 分 图 中 的 元 素 或 者 确保 它们 是 否 被 强调 。 如 
果 要 使 用 颜色 ,我 建议 你 ， 特 别 是 画 草图 时 ， 通 过 包含 一 个 颜色 索引 参考 来 确保 你 用 的 颜色 编 
码 是 明显 的 。 颜 色 能 让 世界 变 得 不 一 样 。 你 所 需 的 只 是 一 些 不 同 颜色 的 白板 、 记 号 笔 和 一 点 点 
想象 力 。 


边框 


在 图 表 元 素 周 围 添 加 边框 ( 比如 双 行 线 、 彩 色 线 、 虚 线 等 ) 是 强调 或 把 相关 元 素 归 类 到 一 起 
的 好 方法 。 如 果 要 这 样 做 ,确保 边框 有 明显 的 意义 , 要 么 给 边框 添加 标签 ,要么 在 图 例 中 包含 一 
个 解释 。 


QD http://en.wikipedia.org/wiki/The Magical Number Seven, Plus or Minus Two 
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布局 

使 用 微软 Visio 或 OmniGraffle 等 电子 绘图 工具 , 让 布局 图 表 元 素 变 得 更 容易 , 因为 你 可 以 随意 
移动 它们 。 很 多 人 更 喜欢 站 在 白板 或 活动 挂图 前 设计 软件 ， 主 要 是 因为 它 提供 了 更 好 的 协作 环境 。 
你 要 多 想 想 岁 表 元 素 的 布局 ， 因 为 如 果 空 间 不 够 ， 你 就 得 不 断 地 画 了 探 ， 擦 了 画 ， 这 会 很 痛苦 。 


用 便签 和 索引 卡 替代 画 框 图 的 例子 


用 便利 贴 和 索引 卡 蔡 代 绘制 框图 可 以 带 来 一 定 的 灵活 性 。 如 果 你 使 用 一 种 类 -职责 -协作 " 式 
技术 来 识别 候选 的 类 /组 件 /服务 ， 可 以 把 所 得 的 卡片 作为 开始 创建 你 的 图 表 的 一 种 方式 。 


需要 移动 一 些 元 素 ? 没 问 题 ， 移 动 它们 。 需 要 移 除 一 些 元 素 ? 没 问题 ， 把 它们 从 图 上 拿 掉 ， 
扔 到 一 边 。 便利 贴 和 索引 卡 是 开始 软件 架构 草图 的 好 方法 ,但 是 我 往往 看 到 所 得 的 图 都 很 杂乱 。 
哦 ， 对 了 ,便利 贴 往往 没 法 好 好 烙 在 白板 上 ， 因 此 还 是 随手 备 一 些 蓝 丁 胶 > 吧 ! 


方向 
想象 你 在 设计 一 个 由 Web 层 、 中 间 层 和 数据 库 构成 的 三 层 的 Web 应 用 程序 。 如 果 要 画 一 个 容 
器 图 ， 你 会 怎么 画 ” 用 户 和 Web 层 在 上 方 ， 数 据 库 在 下 方 ? 别 的 方式 ”或 者 从 左 到 右 排 列 元 素 ? 


我 看 到 的 大 多 数 架 构图 都 把 用 户 和 Web 层 放 在 上 方 ， 但 并 非 总 是 如 此 。 有 时 候 这 些 图 会 上 
下 或 前 后 颠倒 , 这 也 许 说 明了 作者 ( 潜在 的 潜意识 ) 认为 数据 库 是 宇宙 的 中 心 。 尽管 没有 “正确 ” 
的 方向 , 然而 从 我 们 常规 的 思维 来 考虑 , 绘制 “颠倒 ”的 图 要 么 令 人 困惑 , 要么 具有 非凡 的 效果 。 
选择 在 你 。 


QD http://en.wikipedia.org/wiki/Class-Responsibility-Collaboration card 
© http://en.wikipedia.org/wiki/Blu-Tack 
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要 扣 


使 用 UML 的 一 个 优势 是 它 为 各 种 类 型 的 图 表 提 供 了 一 个 标准 化 的 元 素 集 。 理 论 上 ， 如 果 
有 人 熟悉 这 些 元 素 ， 就 应 该 能 理解 你 的 图 。 在 现实 中 情况 并 非 总 是 如 此 ， 但 对 框 线 草 图 来 说 肯 
定 不 是 如 此 ， 是 画图 的 人 逐渐 发 明了 标记 法 。 再 次 ， 这 并 没有 什么 错 ， 但 要 通过 在 图 中 或 旁边 
包含 一 个 小 图 例 来 确保 你 给 每 个 人 平等 的 机 会 去 了 解 你 的 创作 。 这 里 是 几 类 你 可 能 想 要 包含 其 
解释 的 事情 : 
口 形状 ; 
口 线条 ; 
口 颜色 ; 
口 边框 ; 
口 缩 略语 。 


有 时 候 没 有 图 例 ( 比如 “ 灰 框 似乎 是 已 有 系统 ， 红 框 是 新 东西 ”) 你 也 能 理解 图 表 元 素 的 用 
， 但 我 建议 安全 起 见 加 上 一 条 图 例 。 即 使 看 似 明 显 ， 也 会 被 不 同 背景 和 经 验 的 人 误解 。 


党 


图 表 的 评审 清 


软件 架构 流程 就 是 为 软件 项 目 引 入 结构 和 愿景 , 因此 评审 架构 图 时 ， 有 一 些 事情 可 能 是 你 想 
要 坚持 以 确保 情况 就 是 如 此 的 。 这 个 清单 适用 于 在 架构 流程 开始 阶段 产生 的 图 表 , 也 适用 于 那些 
为 一 个 已 有 软件 系统 回顾 性 编写 文档 而 产生 的 图 表 。 


(1) 我 能 从 多 个 抽象 层次 看 到 并 理解 解决 方案 。 

(2) 我 理解 大 局 ,包括 谁 将 使 用 系统 ( 比如 ， 角色、 人 物 等 ) 以 及 现 有 的 开 环境 〈 比如 现 有 
的 系统 ) 有 什么 依赖 。 

(3) 我 理解 逻辑 容器 和 已 作出 的 高 层次 技术 选择 ( 比如 ，Web 服务 器 、 数 据 库 ， 等 等 )。 

(4) 我 理解 哪些 是 主要 组 件 ， 以 及 如 何 使 用 它们 来 满足 重要 的 用 户 故 事 、 用 例 、 功 能 ， 等 等 。 

(5) 我 理解 所 有 这 些 组 件 是 什么 ， 它 们 的 职责 是 什么 ， 还 能 看 到 所 有 的 组 件 都 有 一 个 归属 。 

(6) 我 理解 图 表 使 用 的 表示 法 、 约 定 、 颜 色 编码 ， 等 等 。 

(7) 我 能 看 到 图 表 之 间 的 可 追踪 性 和 一 直 在 使 用 的 图 表 元 素 。 

(8) 我 理解 业务 领域 是 什么 ， 也 能 从 较 高 层次 看 到 软件 系统 提供 的 功能 。 

(9) 我 理解 实现 策略 ( 框架 、 类 库 、API 等 )， 对 于 系统 如 何 被 实现 也 差不多 能 可 视 化 。 


倾听 问题 


最 后 一 点 , 在 图 表 绘 制 中 要 注意 倾听 任何 出 现 的 问题 或 作出 的 说 明 。 如 果 你 发 现 自己 说 这 样 
的 话 ,“ 说 明 一 下 ， 这 些 箭头 表示 数据 流 ”， 确 保 该 信息 体现 在 某 处 的 图 例 中 。 


第 承 承 章 
C4 的 常见 问 题 


当 人 们 基于 我 的 C4 方法 画 架 构图 时 ， 经 常会 问 我 下 面 这 些 问 题 。 


语 境 图 上 的 系统 名 称 

问题 : 你 说 语 境 图 应 该 包括 一 些 必要 的 技术 细节 。 那 系统 名 称 应 该 被 包括 在 内 吗 ? 

回答 : 如 果 你 需要 包括 一 个 众所周知 的 软件 系统 ,那么 我 会 将 它 的 名 称 包括 在 图 中 。 我 可 能 
还 会 只 是 为 了 避免 任何 混淆 而 加 上 一 个 简短 的 职责 声明 来 明确 那个 系统 是 做 什么 的 。 
混合 的 抽象 层次 

问题 : 既然 我 的 系统 容器 图 看 起 来 很 简单 ， 你 会 建议 把 容器 图 和 组 件 图 合 到 一 起 吗 ? 换 名 话 
说 ， 我 能 够 在 一 张 图 上 展 所 有 容器 中 的 全 部 组 件 吗 ? 


回答 : 对 于 简单 的 系统 ， 这 是 一 个 你 可 以 尝试 的 选择 。 我 发 现 ， 即 使 是 微型 系统 ,一 张 图 展 
示 容 器 及 其 组 件 往往 也 太 乱 了 。 我 个 人 的 偏好 是 保持 容器 图 尽 可 能 简单 ,为 图 中 每 一 个 容器 标注 
一 个 简短 的 职责 清单 ， 而 不 是 展示 全 部 组 件 。 这 不 仅 会 得 到 一 张 简洁 的 图 , 还 能 提供 可 以 展示 给 
运营 和 支持 人 员 的 很 好 的 高 层次 技术 图 。 


共享 组 件 


问题 : 我 的 系统 由 一 个 Web 服务 器 和 一 个 独立 应 用 程序 组 成 ， 它 们 都 使 用 一 个 共享 的 数据 
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访问 层 。 我 应 该 怎么 在 图 上 展示 这 一 点 ? 

回答 : 我 会 把 共享 的 数据 库 访 问 组 件 画 在 每 个 适当 的 组 件 图 上 ， 并 用 类 似 “ 这 是 共享 组 件 ” 
的 注解 来 简单 地 注释 。 如 果 有 疑问 ， 问 问 自 己 将 如 何 实际 编码 和 部 署 系统 。 如 果 你 的 共享 组 件 将 
和 其 他 所 有 组 件 一 起 被 部 署 在 一 个 容器 内 ， 那 就 把 它 画 在 图 上 反映 出 来 。 


工具 组 件 
问题 : 如 果 我 有 像 日 志 组 件 这 样 被 所 有 其 他 组 件 使 用 的 东西 , 应 该 怎么 在 图 上 展示 这 一 点 ? 
回答 : 你 有 两 个 选择 ， 然 而 只 有 一 个 倾向 于 得 到 更 简洁 的 图 。 选 项 1 是 把 日 志 组 件 画 在 图 
的 中 间 某 个 位 置 , 并 与 其 他 组 件 连接 起 来 。 尽管 这 是 准确 的 , 你 的 图 却 会 很 快 变 得 混乱 。 选 项 2 
是 把 日 志 组 件 画 在 较 偏 的 某 个 地 方 ， 简 单 标 上 “这 是 一 个 所 有 组 件 都 在 使 用 的 工具 组 件 ” 之 类 
的 注解 。 


从 IT 的 角度 勾画 企业 语 境 
问题 : 我 喜欢 C4 方法 ,但 它 每 次 只 关注 一 个 软件 系统 。 我 们 如 何 能 够 展示 更 多 的 软件 系统 ? 


回答 : 在 现实 世界 中 ,软件 系统 从 不 孤立 地 存在 ， 了 解 各 种 软件 系统 如 何在 企业 的 界限 内 结 
合 在 一 起 往往 是 很 有 用 的 。 要 做 到 这 一 点 ,我 会 简单 地 在 C4 图 上 面 添加 一 个 图 , 从 IT 的 角度 展 
示 企 业 语 境 。 因 此 C4 变 成 了 C5， 额外 的 这 张 图 会 展示 : 


口 组 织 边界 ; 
口 内 部 和 外 部 用 户 ; 
口 内 部 和 外 部 系统 (包括 一 个 对 它们 的 职责 和 拥有 数据 的 高 层次 总 结 )。 


本 质 上 这 变 成 了 企业 级 软件 系统 的 高 层次 地 图 ， 每 个 软件 系统 都 对 应 了 相关 的 C4 层级 。 需 
要 说 明 一 点 , 以 我 的 经 验 , 我 领会 到 企业 架构 并 不 只 是 关于 技术 的 , 但 是 很 多 组 织 并 没有 从 企业 
架构 的 观点 来 看 它们 的 IT 环境 。 事实 上 ， 缺乏 整体 认识 的 各 种 规模 的 组 织 之 多 令 我 震惊 ,特别 
是 考虑 到 IT 通常 是 它们 实现 业务 流程 和 服务 客户 的 一 个 关键 部 分 。 从 技术 的 角度 勾画 企业 语 境 ， 
至 少 提供 了 一 种 跳出 围绕 IT 系统 形成 的 典型 简 仓 来 进行 思考 的 方法 。 
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问 卉 


(1) 你 能 否 解释 你 的 软件 系统 在 不 同 的 抽象 层次 是 如 何 工 作 的 ? 你 会 用 什么 样 的 概念 和 抽象 


层次 来 加 以 解释 ? 


(2) 你 在 使 用 UML 可 视 化 软件 设计 吗 ? 如果 是 , 那 它 有 效 吗 ? 如 果 不 是 , 那 你 用 的 是 什么 ? 


(3) 你 能 否 可 视 化 你 正在 开发 中 的 软件 系统 ?团队 里 其 他 人 都 能 到 


LE 解 你 使 用 的 符号 和 画 的 


图 吗 ? 
(4)“ 架 构 ” 图 中 是 否 包 含 了 技术 选择 ? 


(5) 你 理解 你 的 软件 系统 架构 图 ( 比如 ， 办 公 室 墙 上 、 维 基 及 其 他 形式 ) 吗 ? 如 果 不 理 解 ， 


那么 为 了 让 它们 更 有 效 ， 你 会 做 些 什么 ? 


(6) 你 的 软件 系统 已 有 的 架构 图 ， 是 否 反 映 了 对 代码 的 抽象 ? 如 果 没 有 ， 为 什么 ? 你 打算 如 


何 改变 它 ? 


为 软件 生成 文档 


这 部 分 是 天 于 一 个 我 们 爱 恨 区 加 的 重要 话题 : 


NSS 
U 
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代码 个 会 讲述 完整 的 改 事 


我 们 都 知道 , 编写 好 的 代码 很 重要 ， 重 构 迫 使 我 们 考虑 让 方法 变 得 更 小 、 更 可 复 用 和 自 文 档 
化 。 有 人 说 注释 是 有 害 的 ， 自 注释 的 代码 才 应 该 是 我 们 的 追求 。 不 管 你 怎么 做 , 我 们 每 个 人 都 应 
该 追求 易于 阅读 、 理 解 和 维护 的 好 代码 。 但 是 代码 不 会 讲述 完整 的 故事 。 


让 我 们 想象 一 下 ,你 新 加 入 一 个 正在 进行 中 的 软件 项 目 。 主 要 的 结构 单元 都 到 位 了 , 已 经 交 
付 了 一 些 功能 。 你 启动 了 自己 的 开发 机 ,从 源 代码 控制 系统 下 载 了 代码 并 加 载 到 你 的 开发 环境 中 。 


下 一 步 要 做 什么 ， 如 何 变 得 有 效率 ? 


如 果 没 人 有 时 间 带 你 过 一 遍 代 码 库 , 你 可 以 根据 对 这 个 项 目 有 限 的 了 解 、 业 务 领域 、 你 对 团 
队 如 何 构建 软件 的 期 望 以 及 你 对 所 用 技术 的 知识 ， 做 出 自己 的 假设 。 


举 个 例子 ,你 可 以 通过 代码 库 妇 


I 何 被 拆 分 为 子 项 目 、 目 录 、 包 、 命 名 空间 等 对 软件 系统 的 整 


体 架构 做 出 一 些 判断 。 说 不 定 有 一 些 正在 使 用 的 命名 约定 。 我 们 其 至 能 够 从 前 面 的 微软 Visual 
Studio 屏幕 截图 判断 出 软件 的 一 些 特征 ， 在 这 种 情况 下 它 是 一 个 〈 匿名 ) 的 网 上 银行 系统 。 


辑 层 。 


口 系统 用 C# 在 微软 ,NET 平台 上 编写 。 

口 整个 ,NET 解决 方案 被 分 拆 为 很 多 个 Visual Studio 项 目 ， 有 一 个 被 称 为 ib.web 的 .NET Web 
应 用 程序 ， 你 已 经 料 到 了 ， 因 为 这 是 一 个 网 上 银行 系统 (IB 即 “ 网 上 银行 ”)。 

口 系统 似乎 是 由 多 个 架构 层 组 成 的 。 有 ib.web 和 ib.middletier， 但 我 不 知道 是 否 有 物理 或 逻 


口 项 目 看 起 来 有 一 个 命名 约定 。 如 , iib.middletier.authentication.lib 、ib.middletier.messaging.lib 


和 b.middletier.bankingsystem.lib 似乎 都 是 中 间 层 相关 的 类 库 。 这 些 仅仅 是 类 的 一 种 逻辑 分 


组 ， 还 是 一 些 更 重要 的 东西 ， 比 如 高 层次 组 件 和 服务 ? 
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口 借助 一 些 技 术 知 识 ， 我 能 够 看 到 ib.web 项 目下 潜藏 了 一 个 “服务 引用 ”文件 夹 。 这 是 
Windows 通信 基础 (WCEF ) 服务 的 引用 , 在 这 个 例子 中 , 基本 上 就 是 Web 服务 的 客户 端 。 
它们 的 命名 似乎 对 应 了 中 间 层 的 类 库 ， 因 此 我 认为 我 们 实际 上 拥有 的 是 一 个 分 布 式 系统 ， 
它 有 一 个 暴露 了 一 些 良好 定义 的 服务 的 中 间 层 。 
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人 sinewtr son webste 
.commenb amespace 1ib.cosmon. lib.tormac 
© mddeter 
Cb.mddeter wu 和 adve dkabeoe 由 Static class 
Tb msdeter wud database 


由 1¢ (celephoneNumber != null) 
下 4 
®- Wg Moperties if (!celephoneNunber. IsValid())} 


3 serwepdeences 
> recurn telephoneNumber .OriginalTelephoneNuber; 


1¢ (1scring, IsNullorTmpey (telephoneNumber.CountryPretix)) 


but. Append ("+"); 
[2 buf. Append (telephoneNunber .CountryPretix) ; 
» 


Toemts) Saved 


从 哪 开始 


代码 未 描绘 的 设计 意图 


进一步 深入 代码 会 帮助 验证 你 最 初 的 假设 正确 与 否 , 但 也 可 能 留 给 你 一 大 堆 问 题 。 也 许 你 在 
较 高 层次 明白 系统 做 的 事情 ， 但 不 明白 像 下 面 这 样 的 事 。 46 


口 软件 系统 如 何 融入 已 有 的 系统 形态 ; 

口 为 什么 会 选择 正在 使 用 的 技术 ; 

口 软件 系统 的 整体 结构 ; 

口 各 个 组 件 在 运行 时 部 署 在 哪里 ， 如 何 相互 沟通 ; 

口 Web 层 如 何 “知道 ”在 哪里 找到 中 间 层 ; 

口 日 志 / 配 置 /错误 的 处 理 /其 他 采用 了 什么 方法 ， 在 代码 库 中 是 否 一 致 ; 
口 代码 库 中 是 否 使 用 了 通用 的 模式 和 原则 ; 

口 如 何 添加 新 功能 ， 在 哪里 添加 ; 

口 栈 的 安全 性 是 如 何 实现 的 ; 

口 如 何 实现 可 伸缩 性 ; 
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D 与 其 他 系统 的 接口 如 何 工作 ; 
口 其 他 。 


我 兽 被 要 求 评审 和 参与 开发 没有 文档 的 系统 。 你 当然 可 以 从 代码 的 角度 评估 大 部 分 问题 的 答 
案 , 但 这 会 很 繁重 。 阅读 代 码 的 作用 始终 有 限 , 但 某 些 时 候 你 可 能 需要 向 团队 的 其 他 人 请 教 一 些 
问题 。 如 果 没 有 问 对 问题 ， 你 就 得 不 到 正确 的 答案 : 你 不 知道 你 未 知 的 。 


辅助 信息 


任何 软件 系统 ， 在 代码 之 上 都 有 男 一 个 可 以 回答 这 些 类 型 以 及 更 多 问题 的 信息 层 。 


语 境 : 功能 概览 : 图 。 质量 属性 : 约束 ; 
这 都 是 关于 什么 国 ” 夭 统 能 做 什么 图 是 否 有 重要 的 非 国 是 否 有 重要 的 约束 
功能 需求 


原则 : 软件 架构 : 外 部 接口 : 代码 : 
采用 了 哪些 设 大 局 看 起 来 怎么 有 哪些 外 部 系统 ea 


计 和 开发 原则 样 ? 系统 的 结构 接口 释 的 实现 细节 
如 何 | 


数据 : 基础 设施 架构 : 部 署 : 运营 和 支持 : 
数据 模型 看 起 来 目标 部 署 环境 看 图 软件 和 基础 设施 国 人 们 如 何 运 营 和 
怎么 样 ? 存储 在 起 来 怎么 样 之 间 的 映射 是 什 | 支持 系统 

哪里 么 样 的 


代码 之 上 还 有 一 个 额外 的 信息 层 


文 类 信息 和 代码 是 互补 的 ,应 该 在 某 处 被 捕获 ， 比 如 轻 量 级 的 辅助 文档 , 它 能 描述 代码 自己 
无 法 描述 的 东西 。 代 码 会 讲 故 事 ， 但 不 会 讲述 完整 的 故事 。 


第 天 1 章 


软件 文档 即 指 两 


敏捷 软件 开发 宣言 "说 “ 可 以 工作 的 软件 重 于 面面俱到 的 文档 "， 看 到 很 多 软件 团队 将 其 解 
释 成 “不 写 任何 文档 ”真是 令 人 难以 置信 。 其 中 的 基本 原理 是 ,对 最 终 用 户 来 说 真正 工作 的 软件 
比 一 堆 面 面 俱 到 的 文档 有 价值 得 多 , 但 是 很 多 团队 把 敏捷 宣言 中 的 这 人 句 话 当成 了 完全 不 写 任何 文 
档 的 借口 。 很 遗憾, 代码 不 会 讲述 完整 的 故事 , 缺少 关于 复杂 软件 系统 的 辅助 信息 源 会 让 团队 在 


努力 浏览 代码 时 被 拖累 。 


我 也 坚信 , 软件 团队 有 义务 和 代码 库 一 起 交付 一 些 辅 助 文档 , 特别 是 那些 在 外 包 或 离 岸 合同 
下 构建 软件 的 团队 。 我 见 过 IT 咨询 组 织 交付 高 度 复杂 的 软件 系统 给 客户 时 甚至 没有 一 页 支持 文 
档 , 往往 是 因为 团队 就 没有 任何 文档 。 如 果 原 来 的 软件 开发 者 离开 了 咨询 组 织 , 新 的 团队 能 否 理 
解 软件 的 方方面面 , 它 如何 构 建 以 及 如 何以 契合 原始 架构 的 方式 增强 ?” 那 可 怜 的 客户 怎么 办 ? 是 
不 是 应 该 只 交付 给 他 们 可 工作 的 代码 库 ? 


问题 是 ， 当 软件 团队 考虑 文档 时 ， 他 们 通常 想到 的 是 基于 一 个 1990 年 代 软 件 架 构 文档 模板 
的 庞大 微软 Word 文档 ， 其 中 还 包括 一 个 需要 为 他 们 的 软件 支持 的 每 一 个 用 例 绘制 统一 建 模 语言 
( UML ) 类 图 的 部 分 。 几 乎 没有 人 喜欢 阅读 这 种 类 型 的 文档 ， 更 别 说 写 了 ! 我 们 需要 一 种 不 同 的 
方法 。 我 们 应 该 考虑 把 辅助 文档 作为 一 个 不 断 变化 的 旅游 指南 , 而 不 是 一 个 综合 的 静态 历史 片断 。 


但 这 样 的 指南 应 该 写 些 什么 ? 
1. 地 图 


让 我 们 想象 一 下 , 我 把 你 传送 出 去 , 丢 到 世界 上 某 处 一 条 安静 、 树 木 茂 密 的 乡间 小 道 ( 图 1 )。 


QD http://agilemanifesto.org 


132 程序 员 必 读 之 软件 架构 


你 在 哪里 ， 如何 找 到 这 个 问题 的 答案 ”你 可 以 大 声 呼 救 , 但 这 只 在 附近 有 人 的 时 候 才 管用 。 或 者 
你 可 以 抬 腿 就 走 ， 直 到 认 出 什么 东西 ， 或 者 遇 到 某 些 文明 后 向 他 们 寻求 帮助 。 作 为 极 客 ， 我 们 可 
能 会 打开 智能 手机 上 的 地 图 应 用 程序 ， 用 GPS 来 确定 方位 (图 2 )。 


从 细节 到 大 局 


图 2 的 问题 是 ， 尽管 它 可 以 显示 我 们 的 方位 , 但 “放大 ”得 有 点 多 , 没有 什么 意义 。 如 果 进 
一 步 缩小 ， 最 终 我 们 会 看 到 ， 我 把 你 传送 到 了 泽 西 的 一 条 乡间 小 道 ( 图 3 )。 


接 下 来 的 问题 , 卫星 图 像 显 示 了 很 多 细节 ,相对 于 岛 上 一 些 显 著 的 特征 ， 如 主要 的 道路 和 场 
所 ， 很 难看 出 我 们 在 哪里 。 为 了 解决 这 个 问题 ， 我 们 可 以 移 除 卫 星 图 像 (图 4 )。 尽 管 没 有 那么 
详细 ， 这 种 抽象 却 让 我 们 看 到 了 岛 上 一 些 主要 的 结构 元 素 以 及 地 名 ， 这 正 是 之 前 被 细节 掩盖 的 。 
有 了 这 张 岛 的 简化 视图 , 我 们 可 以 进一步 缩小 , 直到 得 到 一 张 显示 了 译 西 在 欧洲 的 确切 位 置 的 大 
图 (图 5、 图 6 和 图 7)。 所 有 这 些 图 像 从 不 同 的 抽象 层次 显示 了 同一 个 方位 ,每 一 个 都 可 以 帮助 
你 回答 不 同 的 问题 。 


如 果 我 打开 一 个 复杂 软件 系统 的 代码 库 , 随机 突出 一 行 代 码 , 探索 会 很 有 趣 , 但 要 搞 明 白 你 
在 哪里 以 及 代码 如 何 融 入 软件 系统 这 个 整体 , 都 要 花 一 些 时 间 。 大 多 数 集成 开发 环境 都 有 办 法 通 
过 命名 空间 、 包 或 文件 夹 来 浏览 代码 , 但 代码 库 的 物理 结构 和 逮 辑 结构 往往 是 不 同 的 。 举 个 例子 ， 
你 可 以 用 很 多 个 类 组 成 一 个 组 件 ， 用 那些 组 件 再 组 成 一 个 可 部 署 单元 。 

图 表 可 以 作为 地 图 来 帮助 人 们 浏览 一 个 复杂 的 代码 库 , 这 是 软件 的 辅助 文档 最 重要 的 组 成 之 
一 。 理 想 情 况 下 ， 应 该 有 数 张 简单 的 图 表 ， 各 自 展 示 软 件 系统 或 抽象 层次 的 不 同 部 分 。 我 的 C4 
方法 就 总 结 了 软件 系统 的 静态 结构 ， 但 也 有 包括 应 用 UML 在 内 的 其 他 方法 。 
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2. 景色 


如 果 去 泽 西 "， 你 很 可 能 想 要 一 张 地 图 。 你 真 的 应 该 去 ， 那里 太美 了 7。 港口 有 游客 地 图 ， 
洁 地 展示 了 泽 西 的 外 貌 。 基 本 上 ,， 游客 地 图 就 是 这 个 岛 的 详细 草图 ,它们 显示 了 抽象 的 外 观 ， 
不 是 展示 每 一 栋 建 筑 。 虽 然 泽 西 岛 很 小 , 如果 你 没 去 过 的 话 ， 这 些 地 图 打开 一 看 也 会 很 吓人 ， 
此 理想 状态 下 你 需要 一 个 主要 兴趣 点 和 景点 的 清单 。 这 是 人 们 在 假期 会 随身 携带 度假 指南 的 的 主 
要 原因 之 一 。 无 论 是 现实 的 还 是 虚拟 的 〈 例如 你 的 智能 手机 上 的 一 本 电子 书 )， 指 南 无 疑 都 会 列 
出 一 份 你 不 能 不 看 的 顶级 景点 的 清单 。 


代码 库 也 没有 什么 不 同 。 尽管 我 们 可 以 花 很 长 一 段 时 间 绘 图 和 描述 每 一 段 代码 , 但 这 样 做 真 
的 价值 不 大 。 我 们 真正 需要 的 是 列 出 兴趣 点 , 这 样 就 能 集中 精力 去 理解 软件 的 主要 元 素 而 无 需 陷 
入 所 有 的 细节 。 举 个 例子 ， 很 多 Web 应 用 程序 实际 上 都 相当 无 聊 ， 相 比 于 理解 200 多 页 的 每 一 
页 都 如 何 工 作 ， 我 宁愿 看 看 兴趣 点 。 这 可 能 包括 实现 Web 页 面 和 数据 访问 策略 ， 以 及 处 理 安全 
性 和 可 伸缩 性 的 专利 。 


3. 历史 和 文化 

如 果 你 去 过 泽 西 , 你 可 能 会 看 到 一 些 看 起 来 偏离 了 环境 的 东西 , 举 个 例子 , 在 岛 的 南部 海岸 ， 
我 们 有 一 个 可 爱 的 建 于 16 世纪 的 花岗岩 石城 堡 ， 叫 做 伊丽莎白 城堡 ?。 你 一 边 走 一 边 欣 赏 建筑 ， 
最 终 会 到 达 顶 部 , 在 那里 它 看 起 来 就 像 有 人 外 下 的 一 根 混 凝 土 大 柱子 。 这 跟 城 保 周 围 随处 可 见 的 
复杂 的 花岗岩 石雕 格格 不 人 。 当 你 进一步 探索 , 还 会 看 到 有 迹象 表明 城堡 在 二 战 德国 占领 期 间 加 
国 过 。 看 ， 历 史 有 助 于 解释 为 什么 城堡 是 这 样 的 。 

再 次 , 代码 库 没 有 什么 不 同 , 一 些 历 史 、 文 化 和 理念 的 知识 能 够 长 期 地 帮助 你 理解 为 什么 一 
个 软件 系统 是 那样 设计 的 。 这 对 那些 新 加 入 一 个 现 有 团队 的 人 特别 有 用 。 

4. 实用 信息 

旅游 指南 可 能 会 包含 的 最 后 一 件 事 就 是 实用 信息 。 你 知道 , 所 有 关于 货币 、 电 力 供应 、 移 民 、 
地 方法 律 、 当 地 习俗 、 遇 到 困难 如 何 解 决 等 有 用 的 小 知识 。 

如 果 我 们 考虑 一 个 软件 系统 , 实用 的 信息 可 能 包括 在 哪里 找到 源 代码 、 如 何 构 建 、 如 何 部 署 、 
团队 遵循 的 原则 ， 等 等 。 所 有 这 些 都 能 帮助 开发 团队 做 好 他 们 的 工作 。 


轩 弛 | 避 


保持 短小 简洁 
探索 十 分 有 趣 ， 但 始终 要 花 时 间 ， 而 我 们 往往 没有 时 间 。 既 然 代码 不 会 讲述 完整 的 故事 ， 一 
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些 辅 助 文档 就 非常 有 用 , 特别 是 如 果 你 把 软件 交接 给 其 他 人 或 者 经 常 有 人 离开 和 加 入 的 团队 。 我 
的 建议 是 ,把 这 个 辅助 文档 当 作 一 个 指南 ， 它 应 该 给 人 们 上 手提 供 足 够 的 信息 ,帮助 他 们 加 快 探 
索 的 过 程 。 不 过 要 抵挡 住 深入 太 多 技术 细节 的 诱惑 ， 因 为 理解 那个 层次 细节 的 技术 人 员 自 然 知道 
如 何 从 代码 库 找 到 它 。 和 任何 事 一 样 ， 其 中 有 一 个 愉快 的 平衡 点 。 


以 下 标题 描述 了 你 可 能 想 要 包含 在 软件 指南 中 的 事情 : 


() 语 境 ; 

(2) 功能 性 概览 ; 
(3) 质量 属性 ; 

(4) 约束 ; 

(5) 原则 ; 

(6) 软件 架构 ; 

(7) 外 部 接口 ; 

(8) 代码; 

(9) 数据 ; 

(10) 基础 设施 架构 ; 
(11) 部 署 ; 

(12) 运营 和 支持 ; 
(13) 决策 日 志 。 


:十 = 665 99 
) 主 羡 视图 


很 多 典型 的 软件 架构 文档 模板 用 来 编写 辅助 文档 实际 上 没有 那么 糟 ， 但 各 个 部 分 的 名 字 
往往 令 人 困惑 。 如 果 你 看 了 我 刚才 展示 的 标题 清单 ， 可 能 会 好 奇 ， 典 型 的 软件 架构 “视图 ” 
在 哪里 。 


如 果 你 以 前 没 见 看 过 这 些 ， 就 有 很 多 不 同 的 方式 来 察看 一 个 软件 系统 。 例 子 有 IEEE 1471”、 
ISO/EC/EEE 420102、 菲 利 浦 . 克 鲁 西 腾 ( Philippe Kruchten ) “的 4+1 模型 * 等 。 它 们 的 共同 之 
处 是 都 给 一 个 软件 系统 提供 了 不 同 的 “视图 ”来 描述 不 同 的 方面 。 比 如 ， 通 常 有 “逻辑 视图 ”、 
“物理 视图 ”、“ 开 发 视图 ”， 等 等 。 


我 发 现 很 多 方法 都 有 个 大 问题 , 如 果 人 们 不 熟悉 方法 使 用 的 术语 , 很 快 就 会 变 得 困惑 。 比如， 
我 听 过 到 有 人 争论 “概念 视图 ”和 “逻辑 视图 ”有 什么 不 同 。 我 们 还 是 不 要 开始 关于 是 否 人 允许 技 


GD http:/en.wikipedia.org/wiki/IEEE 1471 
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术 出 现在 逻辑 视图 的 问题 吧 ! 观点 也 很 重要 。 如 果 我 是 一 个 软件 开发 者 ,“ 开 发 视图 ”是 不 是 就 
是 代码 , 或 是 说 那 叫 “ 实 施 视图 ”? 但 “物理 视图 ”又 是 什么 ? 我 的 意思 是 , 代码 就 是 物理 输出 ， 
对 吧 ? 但 对 基础 设施 架构 师 而 言 ,“ 物 理 视图 ”又 是 另 一 个 意思 。 但 是 ,假如 目标 部 署 环境 是 虚 
拟 的 而 非 物理 的 呢 ? 


我 的 建议 是 ， 不 管 你 如 何 编写 文档 ， 只 要 明白 你 想 传 达 的 是 什么 ， 并 相应 地 给 各 部 分 命名 。 
解决 术语 问题 的 一 个 选项 是 确保 团队 中 每 个 人 对 各 种 架构 视图 是 什么 都 能 找到 清晰 的 定义 。 在 这 
方面 ， 我 高 度 推荐 约 恩 ' 伍兹 (Eoin Woods ) 和 尼克 “' 罗 桑 斯 基 ( Nick Rozanski ) 所 著 的 《软件 
系统 架构 》"。 另 一 个 方法 是 就 是 将 各 个 部 分 重新 命名 来 消除 歧义 。 


产品 与 项 目 文 档 


最 后 一 点 ,我 这 里 指 的 文档 风格 是 跟 所 构建 的 产品 有 关 ， 而 不 是 创建 /改变 这 个 产品 的 项 目 。 
和 我 一 起 工作 过 的 一 些 组 织 有 将 近 二 十 年 的 软件 系统 , 尽管 它们 有 不 同 数量 的 项 目 级 文档 , 其 中 
却 往 往 没 有 一 个 能 讲述 产品 如 何 工作 、 如 何 演 化 。 通 常 这 些 组 织 有 只 有 一 个 产品 ( 软件 系统 )， 
每 一 次 主要 的 变化 都 作为 一 个 单独 项 目 来 管理 ， 结 果 过 去 20 年 中 产品 发 生 了 巨大 的 变化 ,为 了 
解 软件 当前 的 状态 ， 要 消化 相当 数量 的 项 目 文档 。 在 这 样 的 环境 中 ， 新 员工 往往 只 能 读 读 代码 ， 
跟踪 不 同 项 目 组 产 出 的 文档 来 填补 空白 ， 这 至 少 是 浪费 时 间 ! 


我 建议 软件 团队 为 他 们 构建 的 每 一 款 软 件 系 统 都 创建 一 份 软件 指南 。 这 并 不 意味 着 团队 不 应 
该 创建 项 目 级 别 的 文档 , 但 应 该 有 一 个 地 方 可 以 让 人 找到 关于 产品 如 何 工作 、 如 何 随 着 时 间 演 化 
的 信息 。 一 旦 有 了 这 样 的 软件 指南 ， 改 变 一 个 系统 的 每 一 个 项 目 /变化 流 / 时 间 段 就 是 一 个 小 的 增 
量 。 每 款 产 品 一 份 软件 指南 , 使 得 了 解 软件 当前 的 状态 变 得 简单 得 多 ,也 为 将 来 的 探索 提供 了 非 
常 好 的 起 点 。 


GD http:/www.viewpoints-and-perspectives.info 


语 境 应 该 是 一 份 软件 指南 最 开始 的 部 分 之 一 ， 用 来 为 文档 的 其 余部 分 设置 好 场景 。 
意图 
语 境 部 分 应 该 回答 下 面 几 类 问题 。 
口 这 个 软件 项 目 /产品 /系统 是 关于 什么 的 ? 
口 构建 的 是 什么 ? 
口 它 如 何 融和 人 现 有 环境 ? 〈 比 如， 系统、 业务 流程 等 ) 
口 谁 在 使 用 ? ( 用户、 角色 、 参 与 者 、 人 物 等 ) 


结构 
语 境 部 分 不 需要 太 长 ， 一 到 两 页 就 够 了 ， 语 境 图 是 讲述 放 事 大 部 分 内 容 的 非常 好 的 方式 。 
动机 


我 见 过 不 以 设置 场景 作为 开始 的 软件 架构 文档 ， 看 了 30 页 ， 你 还 是 搞 不 清 为 什么 会 有 这 个 
软件 ， 它 从 何 融入 已 有 的 IT 环境 。 创 建 语 境 部 分 并 不 需要 花 很 长 时 间 ， 但 会 非常 有 用 ， 特 别 是 
对 团队 以 外 的 人 。 


受众 
直接 开发 软件 的 团队 内 外 的 技术 和 非 技术 人 员 。 
是 否 必 须 


是 ， 所 有 软件 指南 都 应 该 包含 设置 场景 的 初始 语 境 部 分 。 


第 灵 人 内 章 
功能 性 概览 


即使 软件 指南 的 目的 不 是 为 了 详细 解释 软件 做 什么 ， 也 有 助 于 扩展 语 境 、 总 结 软件 的 主要 
功能 。 


意图 


这 部 分 让 你 总 结 系统 的 关键 功能 是 什么 。 如 果 它 们 对 架构 很 重要 ,还 能 解释 为 什么 , 就 让 你 
可 以 在 系统 的 功能 切片 ( 用例、 用 户 故事 等 ) 之 间 建 立 明确 的 链接 。 功 能 性 概览 应 该 回答 下 面 几 
类 问题 。 
口 系统 实际 上 做 什么 是 否 清楚 ? 
口 哪些 特性 、 功 能 、 用 例 、 用 户 故事 等 对 架构 是 重要 的 ， 原因 是 否 清楚 ? 
口 重要 的 用 户 是 谁 ( 角色 、 参 与 者 、 人 物 等 ) 以 及 系统 如 何 满足 他 们 的 需求 是 否 清 楚 ? 
口 上 述 已 用 于 塑造 和 定义 架构 是 否 清 楚 ? 
另外 ， 如 果 你 的 软件 自动 化 了 业务 流程 或 工作 流 ， 功 能 试图 应 该 回答 如 下 问题 。 


口 从 流程 的 角度 系统 做 什么 是 否 清楚 ? 
口 系统 的 主要 流程 和 信息 流 是 什么 ? 


结构 


如 果 有 文档 的 话 , 无论 如 何 都 要 参考 ; 我 的 意思 是 功能 规格 、 用 例文 档 或 者 甚至 用 户 故 事 清 
单 。 它 对 总 结业 务 领 域 和 系统 提供 的 功能 往往 很 有 用 。 再 次 ， 图 表 很 有 帮助 ， 你 可 以 使 用 一 个 
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UML 用 例 图 或 一 组 简单 的 线 框图 展示 用 户 界面 的 重要 部 分 。 无 论 哪 种 方式 ， 记 住 这 部 分 的 目的 
是 提供 一 个 概览 。 

男 外 ， 如 果 你 的 软件 自动 化 了 业务 流程 或 工作 流 ， 你 可 以 用 流程 图 或 UML 活动 图 展示 流程 
中 较 小 的 步 又, 以 及 它们 如 何 相互 组 合 。 这 对 突出 进程 交叉 或 合并 等 的 并 行 、 并 发 方面 特别 有 用 。 


动机 


用 图 来 提供 一 个 概览 ,这 个 部 分 不 一 定 需 要 很 长 。 语 境 部 分 总 结 了 软件 如 何 融 入 已 有 的 环境 ， 
这 个 部 分 则 描述 了 软件 实际 上 做 什么 。 再 次 , 这 是 关于 提供 一 个 总 结 以 及 设 定 场景 , 而 不 是 全 面 
地 描述 每 一 个 用 户 / 系 统 交 互 。 


坏人 
学 从 


直接 开发 软件 的 团队 内 外 的 技术 和 非 技 术 人 员 。 


是 否 必须 


是 ， 所 有 软件 指南 都 应 该 包含 对 软件 所 提供 功能 的 总 结 。 


第 .2 CI 章 
质量 属性 


功能 性 概览 部 分 总 结 了 功能 ， 也 值得 包含 一 个 单独 的 总 结 质量 属性 / 非 功 能 需求 的 部 分 。 


意图 


这 部 分 总 结 了 主要 的 质量 属性 ， 应 该 回答 下 面 几 类 问题 。 


口 对 于 架构 必须 满足 的 质量 属性 是 否 有 清晰 的 认识 ? 

口 质量 属性 是 否 满足 SMART 原则 ”( 具体 、 可 衡量 、 可 达成 、 相 关 、 及 时 ) ? 

口 如 果 通 常理 所 当然 的 质量 属性 并 无 必要 ， 是 否 会 明确 标示 为 超出 范围 ( 比如 ,“ 用 户 界面 
元 素 只 用 英语 呈现 ”就 表明 并 没有 明确 考虑 多 语言 支持 ) ? 

口 有 没有 不 切实 际 的 质量 属性 ( 比如 ， 在 很 多 组 织 中 ， 实 现 真正 的 全 天 候 往往 很 昂贵 ) ? 


此 外 ， 如 果 有 任何 质量 属性 被 视 为 “架构 上 重要 的 "， 并 对 架构 产生 影响 ， 为 什么 不 把 它们 
记 下 来 ， 这 样 你 事后 就 能 在 文档 中 查阅 。 


结构 


直接 列 出 每 个 质量 属性 是 一 个 很 好 的 起 点 。 例 子 包 括 : 


口 性 能 ( 比如 延迟 和 吞吐 ); 
口 可 伸缩 性 ( 比如 数据 和 流量 ); 
口 可 用 性 ( 比如 运行 时 间 、 停 机 时 间 、 定 期 维护 、 全 天 候 、99.9% 等 ); 


府 


一 种 日 标 管理 方法 ，http://en.wikipedia.org/wiki/SMART criteria。 译 者 注 
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口 安全 性 ( 比如 认证 、 授 权 、 数 据 保 密 性 等 ); 
口 可 扩展 性 ; 

口 灵活 性 ; 
口 审计 ; 
口 监测 和 管理 ; 

口 可 依赖 性 ; 

口 故障 转移 /灾难 恢复 的 目标 ( 比如 手工 还 是 自动 化 ， 要 花 多 长 时 间 ); 
口 业务 连续 性 ; 
口 互 操作 性 ; 
口 遵守 法 律 法 规 ( 比如 数据 保护 法 ); 
口 国际 化 (il8n ) 和 本 地 化 (110n ); 
口 可 访问 性 ; 

口 易 用 性 ; 
口 等 等 。 


一 个 质量 属性 都 应 该 是 精确 的 ， 不 要 让 读者 来 解释 。 不 属于 这 种 情况 的 例子 包括 : 


每 

口 “ 对 于 要 求 必须 快速 提供 服务 ”; 
口 “ 上 不 封顶 ”; 
口 
口 
口 
口 


“尽快 ”; 
“ 尽 可 能 小 ”; 
“ 尽 可 能 多 的 客户 ”; 


动机 
如 果 你 一 直 是 个 软件 架构 的 好 公民 ,积极 考虑 质量 属性 , 那 为 什么 不 把 它们 写 下 来 呢 ? 质量 


由 于 质量 属性 本 质 上 多 半 是 技术 性 的 ， 这 部 分 实际 上 是 针对 软件 开发 团队 中 的 技术 人 员 。 


是 ， 所 有 软件 指南 都 应 该 包含 对 质量 属性 / 非 功能 性 需求 的 总 结 ， 因 为 它们 通常 以 某 种 方式 
塑造 了 最 终 的 软件 架构 。 


第 .2 7 章 
约 束 


软件 存在 于 现实 世界 的 语 境 中 ， 而 现实 世界 有 约束 。 这 一 部 分 可 以 让 你 说 明 这 些 约束 ,这 样 
你 工作 在 约束 以 内 就 很 清楚 ， 它 们 如 何 影响 你 的 架构 决策 也 很 明显 。 


意图 


约束 通常 是 强加 于 你 的 ,但 不 一 定 是 “ 坏 的 "， 因 为 减少 可 用 的 选项 数目 常常 会 让 你 的 工 
作 一 一 设计 软件 一 一 更 容易 。 这 一 部 分 可 以 让 你 明确 地 总 结 工作 中 受到 的 约束 , 以 及 已 经 为 你 作 
出 的 决策 。 


结构 
就 像 质量 属性 ， 直 接 列 出 并 简要 总 结 已 知 的 约束 就 行 了 。 约 束 的 例子 包括 : 


口 时 间 、 预 算 和 资源 ; 

口 允许 使 用 的 技术 清单 和 技术 约束 ; 

口 目标 部 属 平台 ; 

口 已 有 系统 和 继承 标准 ; 

口 局 部 标准 ( 比如 开发 、 编 码 等 ); 

口 公共 标准 ( 比如 ，HTTP、SOAP、XML 、XML 结构 、WSDL 等 ); 
口 标准 协议 ; 

口 标准 消息 格式 ; 

口 软件 开发 团队 的 规模 ; 
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口 软件 开发 团队 的 技能 配置 ; 

口 所 构建 软件 的 本 质 ( 比如 战术 或 战略 ); 
口 政治 约束 ; 

口 内 部 知识 产权 的 使 用 ; 

口 等 等 。 


如 果 约 束 确实 有 影响 ,就 值得 总 结 ( 比如， 它们 是 什么 、 为 什么 要 强加 它们 ,是 谁 强加 的 )， 
说 明 它 们 对 你 的 架构 有 多 重要 。 
动机 


约束 具有 大 规模 影响 架构 的 能 力 , 特别 是 如 果 它 们 限制 了 可 用 于 构建 解决 方案 的 技术 。 用 文 
档 记 录 下 来 ， 让 你 不 必 在 未 来 回答 关于 为 什么 好 像 做 了 一 些 奇 怪 决 定 的 问题 。 


YY 


) 


众 
参与 软件 开发 过 程 的 每 一 个 人 ， 因 为 有 些 约束 是 技术 性 的 ， 有 些 不 是 。 

是 否 必须 

是 , 所 有 软件 指南 都 应 该 包含 对 约束 的 总 结 ,因为 它们 通常 以 某 种 方式 塑造 了 最 终 的 软件 架 


构 。 任 何 时 候 明 确 做 出 这 些 约束 都 是 值得 的 ， 即 使 在 有 非常 著名 的 约束 集 〈 比如 ,“ 我 们 所 有 的 
软件 都 是 用 ASPNET 访问 SQL 服务 器 数据 库 ”) 的 环境 中 ， 因 为 约束 会 随 着 时 间 不 断 变 化 。 


原则 部 分 总 结 那些 已 经 使 用 (或 正在 使 用 ) 的 设计 和 构建 软件 的 原则 。 


意图 


这 个 部 分 的 目的 就 是 明确 你 要 遵循 的 原则 , 可 以 是 由 利益 相关 者 明确 提出 的 要 求 , 或 者 你 们 
( 即 软 件 开发 团队 ) 想 要 采用 和 遵循 的 原则 。 


结构 


如 果 你 已 经 有 一 套 软 件 开发 原则 〈 比如 在 开发 wiki 上 )， 那 就 直接 参考 。 和 否则 ， 就 列 出 你 遵 
循 的 原则 ， 为 每 一 条 都 加 上 简短 的 解释 或 进一步 信息 的 链接 。 原 则 的 例子 包括 : 


口 架构 分 层 策略 ; 

口 视图 中 没有 业务 逻辑 ; 

口 视图 中 没有 数据 访问 ; 

口 接口 的 使 用 ; 

口 始终 使 用 ORM; 

口 依赖 注入 ; 

口 好 莱 坞 原则 ( 不 要 给 我 们 打 电 话 ， 我 们 会 给 你 打 电 话 ); 

口 高 内 聚 ， 低 耦合 ; 

口 遵循 SOLID? (单一 职责 原则 、 开 闭 原则 、 里 氏 代 换 原则 、 接口 隔离 原则 、 依赖 倒置 原则 ); 


QD http://en.wikipedia.org/wiki/SOLID (object-oriented_design) 
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口 DRY ( don't repeat yourself， 不 要 重复 自己 ); 

口 确保 所 有 组 件 都 是 无 状态 的 ( 比如 ， 让 伸缩 更 容易 ); 
口 选择 一 个 富 域 模 型 ; 

口 先 择 一 个 贫血 域 模 型 ; 

口 始终 选择 存储 过 程 ; 
口 绝 不 使 用 存储 过 程 ; 
口 不 要 重新 发 明 轮 子 ; 

口 错误 处 理 、 日 志 等 的 通用 方法 ; 
口 购买 而 非 构 建 ; 

口 等 等 。 


动机 


写 下 原则 清单 的 动机 是 为 了 明确 它们 , 这 样 参与 软件 开发 的 每 个 人 都 明白 它们 是 什么 。 为 什 
么 ? 简 而 言 之 ， 原 则 确保 了 以 相同 的 方法 处 理 常见 问题 ， 有 助 于 向 代码 库 引 入 一 致 性 。 


世人 入 
学 从 


主要 是 软件 开发 团队 中 的 技术 人 员 。 


是 否 必须 


是 ， 所 有 软件 指南 都 应 该 包含 对 已 经 或 正在 用 于 开发 软件 的 原则 的 总 结 。 


第 .2 .了 章 
软件 架构 


软件 架构 部 分 是 “大 局 ”视图 , 可 以 呈现 出 软件 的 结构 。 传统 的 软件 架构 文档 往往 称 之 为 “ 概 
念 视 图 ”或 “逻辑 视 岁 "， 人 们 常常 对 这 些 视 图 是 否 应 该 指 的 是 技术 选择 之 类 实现 细节 感到 困惑 。 


图 

这 个 部 分 的 目的 是 总 结 你 的 软件 系统 的 软件 架构 ， 这 样 就 能 回答 以 下 问题 。 
口 “大 局 ”看 起 来 是 什么 样 ? 

口 是否 有 清晰 的 结构 ? 

口 从 “30000 英尺 视图 ”看 系统 如 何 工 作 是 否 清 楚 ? 

口 它 展 示 了 主要 的 容器 和 技术 选择 吗 ? 

口 它 展 示 了 主要 的 组 件 及 其 交互 吗 ? 

口 关键 的 内 部 接口 是 哪些 ? (比如 ， 你 的 Web 层 和 业务 层 之 间 的 Web 服务 。) 


结构 


我 用 容器 和 组 件 图 作为 这 个 部 分 的 重点 ， 附 上 一 小 段 解释 图 所 展示 内 容 的 叙述 和 对 每 个 容 右 / 
组 件 的 总 结 。 


放 


有 时 候 ， 展 示 组 件 交 互 的 UML 序列 或 协作 图 是 描绘 软件 如 何 满足 主要 用 例 /用 户 故 事 / 等 的 
一 个 很 有 用 的 方法 。 但 是 ， 要 抵挡 住 描述 每 个 用 例 / 用 户 故 事 如 何 工 作 的 诱惑 ， 只 有 当 它 能 增加 
价值 时 才 这 样 做 ! 
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动机 
写 这 个 部 分 的 动机 是 它 为 人 们 提供 了 可 以 得 到 软件 概览 的 地 图 ， 并 帮助 开发 者 浏览 代码 库 。 


也 人 入 
学 从 


主要 是 软件 开发 团队 中 的 技术 人 员 。 


是 否 必须 


是 , 所 有 软件 指南 都 应 该 包含 软件 架构 部 分 ,因为 要 让 开发 团队 中 每 个 人 都 很 好 地 理解 软件 
整体 结构 ， 它 就 是 必要 的 。 


接口 ,特别 是 软件 系统 外 部 的 ,是 任何 软件 系统 中 风险 最 高 的 部 分 之 一 ， 因 此 总 结 有 哪些 接 
口 以 及 它们 如 何 工作 是 非常 有 用 的 。 


意图 
这 个 部 分 的 目的 是 回答 下 面 几 类 问题 。 
口 关键 的 外 部 接口 是 哪些 ? 


时 比如， 你 的 系统 和 其 他 系统 之 间 的 ( 不管 它 们 在 你 的 环境 内 部 还 是 外 部 )。 
比如 ， 烘 露出 来 用 于 消费 的 API。 
比如， 从 你 的 系统 导出 的 文件 。 


口 每 个 接口 都 从 技术 角度 考虑 过 了 吗 ? 


和 接口 的 技术 定义 是 什么 ? 

昌 如 果 使 用 了 消息 ， 哪 些 队列 〈 点 对 点 ) 和 话题 (发布 -订阅 ) 是 用 于 通信 的 组 件 ? 
和 消息 的 格式 是 什么 〈 比 如 ， 纯 文本 或 DTD/Schema 定义 的 XML ) ? 

到 同步 还 是 异步 ? 

ma 异步 消息 的 连接 有 保障 吗 ? 

和 如 果 必 要 ， 人 们 会 长 期 订阅 吗 ? 

和 消息 能 否 打 乱 顺序 接收 ， 这 是 一 个 问题 吗 ? 

和 接口 是 否 窜 等 ? 
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a 接口 是 否 总 是 可 用 ， 或 者 比如 说 你 是 否 需 要 在 本 地 缓存 数据 ? 
a 性 能 /可 伸缩 性 /安全 性 /其 他 是 如 何 满足 的 ? 


口 每 个 接口 都 从 非 技术 角度 考虑 过 了 吗 ? 
和 接口 所 有 权 属 谁 ? 
昌 接口 多 久 会 有 变化 ， 版 本 怎么 处 理 ? 
@ 是 否 有 服务 级 别 的 协议 ? 
结构 
我 倾向 于 简单 地 ( 以 “从 X 到 Y” 的 形式 ) 列 出 接口 ， 附 上 一 小 段 描 述 接口 特征 的 叙述 。 为 
了 在 语 境 中 理解 这 些 接口 ， 我 会 包含 一 个 强调 接口 的 简化 版 容器 或 组 件 图 。 
动机 


写 这 个 部 分 的 动机 是 为 了 确保 已 经 考虑 和 理解 过 接口 ， 因 为 它们 往往 有 风险 却 容 易 被 忽视 。 
如 果 没 有 得 到 接口 的 细 节 ， 这 个 部 分 可 以 作为 一 个 检查 清单 ， 成 为 团队 要 承担 的 工作 项 目 来 源 。 


受众 


主要 是 软件 开发 团队 中 的 技术 人 员 。 


是 否 必须 


不 是 ， 只 有 当 构 建 的 东西 有 一 个 或 更 多 复杂 接口 时 ， 我 才 会 包含 这 个 部 分 。 举 个 例子 ,在 标 
准 的 “Web 服务 器 一 数据 库 ” 式 软件 系统 中 我 不 包含 它 ， 但 如 果 Web 应 用 程序 需要 跟 一 个 通过 
API 消 费 信 息 的 外 部 系统 通信 ， 我 就 会 包含 这 个 部 分 。 


尽管 软件 指南 的 其 他 部 分 描述 了 软件 的 整体 架构 , 但 你 还 是 想 呈 现 底层 细节 ,解释 工作 原理 。 


这 就 是 代码 部 分 的 目的 。 有 些 软件 架构 文档 模板 将 其 称 为 “实现 祝 J 图 * 或 “开发 视 


意图 


网 "。 


代码 部 分 的 目的 是 描述 软件 系统 中 重要 、 复 杂 、 意 义 重 大 部 分 的 实现 细节 。 比 如 ,我 为 自己 


曾 参与 过 的 软件 项 目 写 了 以 下 内 容 。 


口 数据 绑 定 : 根据 HTTP POST 请 求 更 新 业务 对 象 的 方法 。 

口 多 页 数据 采集 : 简短 描述 构建 跨 网 页 表单 的 内 部 框架 。 

口 Web MVC: 正在 使 用 的 Web MVC 框架 的 一 个 使 用 示例 。 

口 安全 性 : 使 用 Windows 身份 基础 ( WIF ) 进行 认证 和 授权 的 方法 。 
口 域 模型 : 域 模型 重要 部 分 的 概览 。 

口 组 件 框架 : 简短 描述 为 了 在 运行 时 重新 配置 组 件 而 构建 的 框架 

口 简短 描述 代码 库 中 使 用 的 标准 组 件 配 置 机 制 。 

架构 分 层 : 分 层 策略 和 用 来 实现 的 模式 的 概览 。 

口 异常 和 日 志 : 总 结 在 各 个 架构 分 层 中 处 理 异 常 和 记录 日 志 的 方法 。 
口 模式 和 原则 : 解释 模式 和 原则 如 何 实现 。 

口 等 等 。 


口 生成 / 泻 染 HIML: 对 生成 HTML 的 内 部 框架 的 简短 描述 ， 包 括 主要 的 类 和 概念 。 


150 程序 员 必 读 之 软件 架构 


结构 


保持 简单 ， 每 个 想 要 描述 的 元 素 都 只 给 一 小 段 ， 如 果 对 读者 有 帮助 的 话 ， 还 可 以 包含 图 表 。 
举 个 例子 ， 一 个 高 层次 的 UML 类 或 序列 图 有 助 于 解释 内 部 定制 框架 如 何 工作 。 抵 挡住 包含 所 有 
细节 的 诱惑 ， 不 要 觉得 你 的 图 表 需 要 展示 一 切 。 我 喜欢 花 上 几 分 钟 时 间 勾 画 一 个 展示 了 选 定 ( 重 
要 ) 属性 和 方法 的 高 层次 的 UML 类 图 ， 而 不 是 使 用 UML 工具 或 IDE 插件 从 你 的 代码 库 自动 生 
成 的 复杂 图 。 任何 图 都 保持 在 一 个 较 高 层次 的 细节 意味 着 着 它们 能 在 更 长 时 间 内 较 少 变动 , 保持 
最 新 ， 因 为 它们 能 够 忍受 代码 的 微小 变化 而 仍然 有 效 。 


动机 


写 这 个 部 分 的 动机 是 为 了 确保 每 个 人 都 了 解 软件 系统 重要 /意义 重大 /复杂 的 部 分 如 何 工作 ， 
这 样 人 们 就 能 够 以 一 致 和 连贯 的 方式 维护 、 增 强 和 扩展 它们 。 这 个 部 分 也 有 助 于 团队 的 新 成 员 迅 
速 行动 起 来 。 


受众 


主要 是 软件 开发 团队 中 的 技术 人 员 。 


是 否 必须 


不 是 ， 但 除了 不 重要 的 软件 系统 ， 我 通常 都 会 包含 这 个 部 分 。 


一 个 软件 系统 相关 的 数据 通常 不 是 主要 关注 点 , 却 可 以 说 比 软件 本 身 更 重要 , 所 以 对 它 做 一 
些 文档 常常 是 有 用 的 。 


意图 
数据 部 分 的 目的 是 记录 任何 从 数据 的 角度 来 看 重要 的 东西 ， 回 答 下 面 几 类 问题 。 


口 数据 模型 看 起 来 是 什么 样 ? 

口 数据 存储 在 哪里 ? 

口 谁 拥 有 数据 ? 

口 数据 需要 多 少 存储 空间 ? ( 比如 ， 特 别 是 如 果 你 在 处 理 “ 大 数据 ”。 ) 
口 归档 和 备份 策略 是 什么 ? 

口 业务 数据 的 长 期 归档 是 否 有 法 规 要 求 ? 

口 日 志文 件 和 审计 跟踪 是 否 有 类 似 的 要 求 ? 

口 是 否 用 简单 文件 来 存储 ? 如 果 是 ， 用 的 是 哪 种 格式 ? 


结构 

一 个 短小 的 部 分 包含 你 要 描述 的 每 个 元 素 , 保持 简单 ; 如 果 对 读 考 有 帮助 ， 再 包含 域 模型 或 
实体 关系 图 。 就 像 我 在 代码 部 分 的 包含 类 图 的 建议 , 让 任何 图 都 停留 在 较 高 的 抽象 层次 ,而 不 是 
包含 每 一 个 字段 和 属性 。 如 果 有 人 需要 这 类 信息 ，( 举 个 例子 ) 他 们 可 以 在 代码 或 数据 库 中 找到 。 
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动机 
写 这 个 部 分 的 动机 是 大 多 数 软件 系统 的 数据 往往 比 软件 存在 得 更 久 。 这 个 部 分 可 以 帮助 任何 


需要 持续 维护 和 支持 数据 的 人 , 再 加 上 任何 需要 在 数据 上 提取 报表 或 进行 商业 智能 活动 的 人 。 软 
件 系统 在 将 来 不 可 避免 地 要 重 写 ， 这 个 部 分 还 可 以 作为 一 个 起 点 。 


坏人 
学 从 


主要 是 软件 开发 团队 中 的 技术 人 员 以 及 其 他 可 以 协助 部 署 、 支 持 和 运营 软件 系统 的 人 。 


是 否 必须 


不 是 ,但 除了 不 重要 的 软件 系统 ， 我 通常 都 会 包含 这 个 部 分 。 


第 。2 7 章 
基础 设施 架构 


大 多 数 的 软件 指南 都 专注 于 软件 本 身 , 然而 我 们 也 确实 需要 考虑 基础 设施 , 因为 软件 架构 是 
关于 软件 和 基础 设施 的 。 


意图 


这 个 部 分 描述 软件 将 会 部 署 到 的 物理 /虚拟 硬件 和 网 络 。 虽 然 作 为 一 个 软件 架构 师 ， 你 可 以 
不 参与 基础 设施 的 设计 , 但 还 是 需要 了 解 ， 让 你 有 能 力 满足 目标 就 够 了 。 这 个 部 分 的 目的 是 回答 
下 面 几 类 问题 。 


口 是 否 有 清晰 的 物理 架构 ? 

口 在 所 有 的 层 中 ， 什 么 硬件 〈 虚 拟 或 物理 ) 做 了 这 件 事 ? 

口 如 果 适 用 ， 它 是 否 满足 元 余 、 故 障 转移 和 灾难 恢复 ? 

口 选择 的 便 件 组 件 如 何 改变 大 小 和 被 选中 是 否 清楚 ? 

口 如 果 使 用 了 多 个 服务 器 和 网 站 ， 它 们 之 间 的 网 络 联系 是 什么 ? 


口 诊 


负责 基础 设施 的 支持 和 维护 ? 


口 有 照管 通用 基础 架构 〈 比 如， 数据 库 、 消 息 总 线 、 应 用 程序 服务 器 、 网 络 、 路 由 咒 、 交 
换 机 、 负 载 均衡 咒 、 反 向 代理 、 互 联网 连接 等 ) 的 中 心 团队 吗 ? 


口 诊 


拥有 资源 ? 


口 开发 、 测 试 、 验 收 、 试 制 、 生 产 等 是 否 有 合适 的 环境 ? 
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这 个 部 分 的 主要 关注 点 通常 是 展示 各 种 硬件 /网 络 组 件 以 及 如 何 相互 融合 的 基础 设施 /网 络 
图 ， 配 合 简短 的 叙述 。 


基础 设施 图 示例 ， 往 往 在 微软 Visio 中 创建 
如 果 我 在 一 个 大 型 组 织 中 工作 , 通常 会 有 一 个 照管 基础 设施 架构 并 为 我 创建 这 些 图 的 基础 设 
施 架构 师 。 有 了 时候 情况 不 是 这 样 ， 尽 管 我 会 自己 来 画 它们 。 
动机 


写 这 个 部 分 的 动机 是 强迫 我 ( 软件 架构 师 ) 走出 自己 的 舒适 区 去 思考 的 基础 设施 架构 。 如 果 
我 不 理解 它 , 有 可 能 我 创建 的 软件 架构 就 不 会 工作 ,或 者 已 有 的 基础 设施 不 会 支持 我 尝试 做 的 事 。 


王八 
学 从 


主要 是 软件 开发 团队 中 的 技术 人 员 以 及 其 他 可 以 协助 部 署 、 支 持 和 运营 软件 系统 的 人 。 


是 否 必须 


是 ,所 有 软件 指南 都 应 该 包含 基础 设施 架构 部 分 ,因为 它 表 明基 础 设施 已 经 理解 并 考虑 过 了 。 


第 .了 df 章 
el 看 


部 署 部 分 就 是 软件 和 基础 设施 之 间 的 映射 。 


意图 


这 个 部 分 是 用 来 描述 软件 ( 比如 容器 ) 和 基础 设施 之 间 的 映射 。 有 时 候 这 是 简单 的 一 对 一 映 
射 (比如 ,把 一 个 Web 应 用 程序 部 署 到 单个 Web 服务 器 上 )， 其 他 时 候 会 更 复杂 ( 比如 ， 把 一 个 
Web 应 用 程序 部 署 到 服务 器 集群 的 多 个 服务 器 上 )。 这 个 部 分 回答 下 面 几 类 问题 。 


口 软件 安装 和 配置 软件 在 哪里 ， 怎 么 做 ? 

口 软件 如 何 部 署 到 基础 设施 架构 部 分 描述 的 基础 设施 元 素 上 是 否 清楚 ? ( 比如， 一 对 一 映 
射 、 每 个 服务 需 多 个 容器 等 。) 

口 如 果 这 仍 待 决定 ， 有 哪些 选项 ， 是 否 做 了 文档 ? 

口 内 存 和 CPU 在 运行 于 单 块 基础 设施 上 的 进程 间 如 何 分 配 是 否 清楚 ? 

口 有 容器 或 组 件 以 主动 -主动 、 主 动 -被 动 、 热 备用 、 冷 备用 等 形态 运行 吗 ? 

口 部 署 和 回 滚 策略 是 否 已 经 定义 ? 

口 软件 或 基础 设施 出 现 故障 时 会 发 生 什 么 ? 

口 跨 站 点 的 数据 如 何 复制 是 否 清楚 ? 


结构 


有 几 种 方式 来 组 织 这 个 部 分 的 结构 。 
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(1) 表格 : 展示 软件 容器 和 组 件 之 间 映 射 以 及 它们 将 被 部 署 到 的 基础 设施 的 简单 文本 表格 。 
(2) 图 表 : 展示 软件 在 哪里 运行 的 UML 部 署 图 或 者 基础 设施 架构 部 分 图 的 修改 版 。 


在 这 两 种 情况 下 , 我 可 以 使 用 颜色 编码 指定 软件 和 基础 设施 的 运行 时 状态 (比如, 主动、 被 
动 、 热 备用 、 暖 备用 、 冷 备用 等 )。 
动机 


写 这 个 部 分 的 动机 是 为 了 确保 我 理解 软件 一 旦 脱离 开发 环境 将 会 如 何 工作 , 还 要 为 往往 很 复 
杂 的 企业 软件 系统 部 署 记 录 文 档 。 

这 个 部 分 能 够 提供 一 个 有 用 的 概览 ， 其 至 是 对 那些 采用 持续 发 布 的 团队 ”， 并 用 Puppet 或 
Chef 之 类 的 工具 把 所 有 的 部 署 脚 本 化 。 


世人 入 
学 从 


主要 是 软件 开发 团队 中 的 技术 人 员 以 及 其 他 可 以 协助 部 署 、 支 持 和 运营 软件 系统 的 人 。 


是 否 必须 


是 , 所 有 软件 指南 都 应 该 包含 部 署 部 分 , 因为 它 有 助 于 解决 软件 部 署 在 哪里 或 者 已 经 在 哪里 
的 神秘 问题 。 


人 http://continuousdelivery.com 
© https:/puppetlabs.comy/。 译 者 注 
@ http:/www.getchef.com/。 一 一 译 者 注 


第 2 O 章 
运营 和 支持 


运营 和 支持 部 分 描述 人 们 如 何 运 行 、 监 测 和 管理 你 的 软件 。 


省 
区 


大 多 数 系统 都 会 受到 所 支持 的 运营 需求 的 限制 , 特别 是 关于 如 何 进 行 监测 、 管 理 和 执行 。 在 
软件 指南 中 包含 一 个 专门 的 部 分 可 以 让 你 明确 你 的 软件 如 何 支 持 那些 需求 。 这 个 部 分 应 该 处 理 下 
面 几 类 问题 。 


口 软件 如 何 为 运营 /支持 团队 提供 监测 和 管理 系统 的 能 力 是 否 清楚 ? 

口 在 架构 的 各 个 分 层 中 这 是 如 何 实 现 的 ? 

口 运营 人 员 要 如 何 诊断 问题 ? 

口 错误 和 信息 记录 在 哪里 ? (比如 ， 日 志文 件 、Windows 事件 日 志 、SNMP 、JMX、WMI、 
自 定 义诊 断 等 。) 

口 更 改 配置 是 否 需 要 重新 启动 ? 

口 有 需要 定期 执行 的 手动 管理 任务 吗 ? 

口 旧 数 据 需要 定期 归档 吗 ? 


结构 


这 个 部 分 本 质 上 是 叙事 性 的 ， 每 个 标题 对 应 一 组 相关 的 信息 〈 比如 监测 、 诊 断 、 配 置 等 )。 
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动机 
我 承担 过 对 已 有 软件 系统 的 审计 工作 ， 我 们 不 得 不 花 时 间 搜 寻 日 志文 件 的 位 置 等 基本 信息 。 


时 代 变 了 , 团队 成 员 也 继续 前 进 , 因此 记录 这 些 信 息 有 助 于 防止 将 来 发 生 没有 人 明白 如 何 运 营 软 
件 的 情况 。 


世人 入 
学 从 


主要 是 软件 开发 团队 中 的 技术 人 员 以 及 其 他 可 以 协助 部 署 、 支 持 和 运营 软件 系统 的 人 。 


是 否 必须 


是 , 所 有 软件 指南 都 应 该 包含 运营 和 支持 部 分 , 除非 你 喜欢 把 软件 扔 进 黑洞 , 然后 只 往 好 处 想 。 


你 可 能 会 考虑 包含 在 软件 指南 中 的 最 后 一 件 事 是 在 软件 系统 开发 过 程 中 做 出 决策 的 日 志 。 


意图 
这 个 部 分 的 目的 是 简单 记录 所 做 的 重要 决策 , 包括 技术 选择 ( 比如 , 产品、 框架 等 ) 和 整体 
架构 ( 比如 ， 软 件 的 结构 、 架 构 风 格 、 分 解 、 模 式 等 )。 
口 你 为 什么 选择 技术 或 框架 X， 而 不 是 Y 和 2? 
口 你 是 怎么 做 的 ?产品 评估 还 是 概念 证 明 ? 
口 你 是 否 根 据 公司 政策 或 企业 架构 战略 而 被 迫 做 出 关于 XX 的 决策 ? 
口 你 为 什么 选择 所 采用 的 软件 架构 ?你 考虑 过 其 他 哪些 选项 ? 
口 你 怎么 知道 解决 方案 满足 主要 的 非 功 能 性 需求 ? 
口 等 等 。 


结构 


再 说 一 次 , 用 一 小 段 文字 描述 你 要 记录 的 每 个 决策 , 保持 简单 。 如 果 有 其 他 资源 ， 比 如 概念 
证 明 、 性 能 测试 结果 或 产品 评价 ， 一 定 要 参考 。 


动机 
记录 重要 决策 的 动机 是 这 个 部 分 在 将 来 可 以 作为 一 个 参考 点 。 所 有 的 决策 都 是 依据 特定 的 语 
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境 做 出 的 ， 通 常 都 有 取舍 。 对 一 个 给 定 的 问题 ， 通 常 没有 完美 的 解决 方案 。 事 后 阐明 决策 过 程 
往往 是 复杂 的 , 尤其 是 如 有 果 你 向 刚 加 入 团队 的 人 解释 这 个 决策 , 或 者 处 在 一 个 定期 变化 语 境 的 环 
境 中 。 


尽管 “从 未 有 人 因为 购买 IBM 而 遭 解 雇 ” ， 也 许 写 下 公司 政策 强迫 你 使 用 IBM WebSphere 
而 不 是 Apache Tomcat 的 事实 ， 会 在 将 来 为 你 省 去 一 些 令 人 头 大 的 对 话 。 


坏人 
学 从 


主要 是 软件 开发 团队 中 的 技术 人 员 以 及 其 他 可 以 协助 部 署 、 支 持 和 运营 软件 系统 的 人 。 


是 否 必须 


不 是 ,但 如 果 我 们 ( 团队 ) 在 考虑 技术 选择 或 架构 风格 之 类 的 重要 事情 上 花费 超过 几 分 钟 ， 
我 通常 都 会 包含 这 个 部 分 。 如 果 有 疑问 , 花 儿 分 钟 写 下 来 , 特别 是 当 你 为 一 个 在 外 包 协 议 下 给 客 
户 构 建 软件 系统 的 咨询 组 织 工作 时 。 


第 7 章 


问 碟 


(1) 我 们 都 应 该 努力 写 出 自 文档 化 的 代码 ， 但 这 样 就 够 了 吗 ? 如 果 不 够 ， 还 缺少 什么 ? 

(2) 你 会 给 你 的 软件 系统 写 文 档 吗 ?如 果 会 ， 为 什么 ”如 果 不 会 ， 又 是 为 什么 ? 

(3) 如 果 你 有 很 多 项 目 级 的 文档 ， 但 只 有 很 少 产 品级 的 文档 ， 新 加 入 团队 的 人 该 如 何 理解 你 
的 软件 系统 ?” 怎样 可 以 让 他 们 更 轻松 一 点 ? 

(4) 在 你 所 处 环境 中 ， 你 认为 什么 是 最 低 水 平 的 辅助 软件 文档 ? 

(5) 你 的 辅助 文档 保存 在 什么 地 方 ( 比如 : 源码 控制 系统 、 网 络 文件 共享 、SharePoint 、 维 基 61 
等 ) ?对 你 的 目标 群体 来 说 这 是 最 好 的 方案 吗 ? 


开发 生命 ;周期 中 的 软件 加 构 


最 后 这 部 分 将 探讨 如 何 将 前 面 的 内 容 融 入 软件 开 
和 的 日 党 工作 ， 也 会 解答 应 该 做 多 少 软 件 架 构 (以 及 
预先 设计 ) 这 一 问题 。 


圈 


第 人. 色 章 


敏捷 和 架构 的 冲突 昼 话 偿 是 现 买 


“人 敏捷 ”和 “架构 ” 常 被 看 作 是 互 斥 的 ， 然 而 现实 却 往往 相反 。 有 些 软件 团队 认为 架构 是 不 
必要 的 恶魔 ， 另 一 些 则 认为 他 们 需要 重新 考虑 架构 。 

概括 来 说 ， 架 构 就 是 结构 和 愿景 ， 这 个 过 程 的 关键 在 于 理解 重要 设计 决策 。 即 使 是 最 敏捷 的 
软件 项 目 都 会 有 一 些 架 构 的 顾虑 ， 真 的 应 该 预先 考虑 ,除非 你 经 营 的 是 最 精益 的 初创 公司 ,否则 
也 确实 找 不 到 方向 。 因 此 ， 敏 捷 软 件 项 目 需 要 “架构 ”"， 但 这 似乎 与 过 去 十 多 年 所 宣传 的 敏捷 相 


悖 。 一 句 话 ， 敏 捷 项 目 需 要 架构 ， 因 此 敏捷 和 架构 并 不 冲突 。 那 么 ， 冲 突 在 哪里 ? 


冲突 1: 团队 结构 


架构 和 敏捷 软件 开发 方法 之 间 的 第 一 个 冲突 与 团队 结构 有 关 。 传统 的 软件 架构 方法 会 有 一 个 
专门 的 软件 架构 师 , 他 们 就 好 像 来 自 远 离 软 件 构建 流程 的 象牙 塔 中 的 独裁 者 。 解决 方案 架构 师 只 


提供 大 量 设计 文档 给 开发 团队 ， 


放手 不 管 , 造成 严重 破坏 。 这 种 不 幸 的 刻板 印象 导致 在 软件 开发 


队 中 安排 一 个 专门 的 架构 师 的 做 法 遭 到 反对 。 


敏捷 软件 开发 团队 努力 争取 的 目标 之 一 , 是 减少 用 文档 传递 来 沟通 产生 的 管理 开支 。 对 有 些 
组 织 来 说 , 这 是 加 强 合作 、 减 少 浪费 的 正确 做 法 。 这 些 组 织 往往 更 愿意 组 建 由 通才 组 成 的 、 几 乎 


可 以 胜任 各 种 任务 的 小 团队 。 和 
必须 由 跨 职能 的 团队 成 员 组 成 ， 
要 讨厌 的 架构 师 ”! 


有 实 上 ， 由 于 敏捷 方法 的 宣传 方式 , 一 种 常见 的 看 法 是 , 敏捷 团队 
并 且 是 自 组 织 的 。 结 果 呢 ?很 多 敏捷 团队 会 告诉 你 , 他 们 “不 需 
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冲突 2: 流程 和 产 出 


第 二 个 冲突 ， 是 敏捷 和 大 型 预先 设计 在 流程 和 期 望 产 出 ( 即 人 们 常 说 的 架构 ) 上 的 差异 。 敏 
捷 方 法 的 主要 目标 之 一 是 周期 性 少量 地 提供 客户 价值 ， 这 关乎 快速 行动 、 接 收 反馈 、 拥 抱 变 化 。 
而 大 型 预先 设计 的 目标 是 在 蓝图 (通常 是 一 个 计划 ) 到 位 前 ， 对 全 部 事情 达成 共识 。 


敏捷 宣言 "更 推崇 “随机 应 变 ” 而 非 “ 依 计划 行事 ”， 但 这 显然 不 意味 着 不 做 任何 计划 ， 似 乎 
有 些 敏 捷 团队 害怕 做 任何 一 点 “分 析 ”。 结 果 为 了 避免 大 型 预先 设计 ， 敏 捷 团 队 常 常 不 做 任何 预 
先 设计 ， 而 是 用 “浮现 式 设计 ”或 “演化 架构 ”之 类 的 术语 来 为 他 们 的 做 法 辩解 。 我 还 听 说 有 团 
队 宣 称 他 们 采用 的 测试 驱动 开发 (TDD，Test Driven Development ) 根本 不 需要 “架构 ”， 但 也 就 
是 这 些 团 队 在 将 来 某 个 时 候 会 为 不 断 重 构 所 累 。 


软件 架构 提供 了 TDD、BDD、DDD、RDD 和 代码 整洁 的 分 界线 


每 当 我 和 团队 谈 起 软件 架构 , 都 有 一 个 被 反复 问 到 的 问题 , TDD”、BDD”、DDD”、RDD"” 等 
技术 跟 架 构 的 关系 如 何 ? 这 个 问题 其 实 是 问 xDD 是 否 是 “软件 架构 ”的 替代 ， 特 别 是 在 “敏捷 
环境 ”中 。 简短 的 回答 是 否定 的 。 稍 长 的 回答 是 ,思考 软件 架构 的 过 程 其 实 是 确定 范围 在 范围 
之 内 你 可 以 用 任何 一 种 xDD 和 你 喜欢 的 敏捷 实践 来 构建 软件 。 


对 我 来 说 ， 原 因 很 简单 :你 需要 思考 架构 的 驱动 力 (影响 最 终 软 件 架 构 的 重要 事情 )， 包括 
下 面 这 些 。 


口 功能 需求 : 需求 驱动 架构 。 不 管 怎么 捕 提 和 记录 需求 ( 比如 ， 用 户 故 事 、 用 例 、 需 求 规 

格 书 、 验 收 测试 等 )， 你 都 要 大 概 知道 你 在 构建 什么 。 

口 质量 属性 : 非 功能 需求 ( 比如 ， 性 能 、 可 扩展 性 、 安 全 等 ) 通常 是 技术 方面 的 ， 也 很 难 
改造 。 理 论 上 ， 这 些 都 需要 体现 在 初始 的 设计 中 ， 忽 视 这 些 属性 会 导致 软件 系统 要 么 做 
得 不 够 ， 要 么 做 得 太 过 。 

口 约束 : 约束 普遍 存在 于 现实 世界 ， 包 括 批准 的 技术 清单 、 规 定 的 集成 标准 、 目 标 部 署 环 
境 、 团 队 规模 等 。 再 说 一 次 ， 不 考虑 这 些 会 导致 你 交付 的 软件 系统 与 环境 不 匹配 ， 增 加 
不 必要 的 摩擦 。 

口 原则 : 是 在 试图 为 软件 提供 一 致 性 和 清晰 度 时 你 想 要 采用 的 东西 。 从 设计 的 角度 来 看 ， 

这 包括 你 的 分 解 策略 ( 比如 ， 层 、 组 件 和 微服 务 的 对 比 ) 关注 点 分 离 、 架 构 模 式 等 。 明 

确 概 述 一 套 初 始 的 原则 至 关 重 要 ， 这 样 构建 软件 的 团队 才 会 朝 着 同一 方向 出 发 。 


QD http://agilemanifesto.org 

@ 测试 驱动 开发 ，http://en.wikipedia.org/wiki/Test-driven_development。 

@) 行为 驱动 开发 ，http:/en.wikipedia.org/wiki/Behavior-driven_development。 
人 由 领域 驱动 设计 ，http:/en.wikipedia.org/wiki/Domain-driven_design。 

@) 责任 驱动 设计 ，http://en.wikipedia.org/wiki/Responsibility-driven_design。 
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从 象牙 塔 和 大 型 预先 设计 中 分 离 出 架构 


多 数 情 况 下 , 这 些 冲突 会 造就 缺乏 合适 的 技术 领导 力 的 混乱 团队 。 结果 如 何 ” 做 出 来 的 软件 
系统 看 起 来 一 团 乱 ， 也 不 符合 非 功能 需求 等 关键 的 架构 驱动 力 。 


架构 是 改变 起 来 很 困难 或 者 成 本 很 高 的 东西 ， 跟 那些 你 不 能 用 一 个 下 午 就 轻松 完成 重 构 的 、 
大 的 或 者 “主要 ”的 决策 有 关 。 它 包括 核心 技术 选择 ,全 面 的 高 层次 结构 ( 全 局 ) 以 及 对 如 何 解 
决 各 种 复杂 、 高 风险 、 关 键 问题 的 理解 ， 等 等 。 软 件 架 构 很 重要 。 


大 型 预先 设计 通常 涵盖 了 这 些 对 架构 的 顾虑 , 但 往往 想 得 太 多 。 有 一 个 技巧 来 区 分 哪些 是 重 
要 的 : 定义 一 个 高 层次 结构 ， 设 定 愿景 ,这 很 重要 ; 在 开始 编码 之 前 ,绘制 无 数 个 类 的 详 图 ， 则 
多 半 不 重要 。 搞 清楚 如 何 解决 怪异 的 性 能 需求 很 重要 , 搞 清 楚 每 个 数据 库 字 段 的 长 度 就 不 太 重 要 。 

敏捷 和 架构 并 不 冲突 。 与 其 育 目 听从 别人 的 指点 ,软件 团队 更 应 剔除 炒作 , 理解 技术 领导 力 
的 方式 ， 在 其 独特 的 环境 下 量化 所 需 的 预先 设计 。 

考虑 架构 的 驱动 力 不 需 要 花 很 长 时 间 , 却 能 为 软件 设计 的 其 他 部 分 提供 一 个 开始 。 当 然 , 这 
并 不 意味 着 架构 不 应 该 更 改 , 特别 是 当 你 开始 编写 代码 、 获 得 反馈 后 。 关 键 在 于 你 现在 有 了 一 个 
框架 和 一 定 的 工作 范围 , 能 为 团队 提供 一 些 经 常 需 要 的 愿景 和 指导 。 我 的 经 验 是 小 方向 有 大 用 场 。 


第 CG .了 章 
量化 风险 


识别 风险 是 恰如其分 的 预先 设计 的 一 个 关键 的 部 分 , 简 而 言 之 , 风险 就 是 未 来 可 能 发 生 的 坏 
事 ， 比 如 所 选 技术 无 法 满足 供应 商 的 承诺 。 然 而 风险 并 不 平等 ， 有 一 些 比 其 他 的 更 重要 。 举 个 例 
子 ， 一 个 可 能 会 使 你 的 软件 项 目 失败 的 风险 应 该 比 导 致 团队 某 种 不 适 的 事情 拥有 更 高 的 优先 级 。 


假设 有 一 个 风险 清单 ( 风险 风暴 是 做 这 件 事 的 非常 好 的 技术 )， 你 会 如 何 量 化 这 些 风险 ， 并 
评估 它们 的 相对 优先 级 ? 有 一 些 行 之 有 效 的 风险 量化 方法 ,包括 分 配 一 个 低 、 中 或 高 的 值 ， 甚至 
1~10 的 一 个 简单 的 数值 ， 数 字 越 大 代表 风险 等 级 越 高 。 


概率 与 影响 


考虑 风险 的 一 个 好 方法 是 从 发 生 风险 的 负面 影响 中 分 离 出 发 生 的 概率 。 


口 概率 : 发 生 风 险 的 可 能 性 有 多 大 ? 你 是 否认 为 机 会 很 微小 ， 要 不 来 点 现金 财 注 ? + 影响 : 
如 果 确 实 发 生 了 风险 ， 有 什么 负面 影响 ”团队 是 否 感到 不 适 ， 会 不 会 全 部 返工 ? 或 者 它 
会 导致 你 的 软件 项 目 失败 吗 ? 


概率 和 影响 都 可 以 量化 为 低 、 中 、 高 或 者 就 是 一 个 数值 。 如 果 你 把 概率 和 影响 分 开 考虑 ， 就 
可 以 像 下 图 一 样 ， 将 矩阵 中 的 两 项 分 数 相 乘 得 到 整体 的 评分 。 
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风险 量化 的 概率 /影响 矩阵 


设 定 风险 的 优先 级 
根据 风险 评分 , 设 定 其 优先 级 就 跟 给 它们 排名 一 样 简单 。 概率 低 影响 小 的 风险 可 以 被 设 定 为 
低 优先 级 风险 。 相 反 ， 概 率 高 影响 大 的 风险 则 需要 设 定 为 高 优先 级 。 如 同 颜色 编码 所 示 。 


+ 绿色 : 1 分 或 2 分 ， 低 优先 级 风险 。+ 褐色: 3 分 或 4 分 ， 中 等 优先 级 风险 。+ 红 色 : 6 分 
或 9 分 ， 高 优先 级 风险 。 


往往 很 难 判断 你 应 该 重点 关注 哪些 风险 , 如 果 搞 错 了 , 就 会 把 缓解 风险 的 努力 用 在 错误 的 地 
方 。 量 化 风险 为 你 提供 了 一 种 方法 ， 关 注 那 些 最 有 可 能 导致 软件 项 目 失败 或 者 你 被 解雇 的 风险 。 


第 CG 了 笑 章 
风险 风暴 


风险 识别 是 恰如其分 的 预先 设计 的 一 个 关键 部 分 , 但 因 其 往往 被 视 为 无 聊 的 琐事 , 很 多 软件 
团队 都 盖 于 为 之 。 风 险 风 暴 是 一 种 快速 、 有 趣 、 协 作 和 视觉 的 风险 识别 技术 , 整个 团队 都 能 参与 。 
它 有 4 个 步 又 。 


步骤 1: 画 一 些 架 构图 


第 一 步 是 在 白板 或 大 张 的 活动 挂图 纸 上 夯 一 些 架 构图 。C4 是 一 个 很 好 的 起 点 ， 因 为 它 提供 
了 一 种 获得 一 组 抽象 层次 各 异 的 图 的 方法 ,其 中 一 些 可 用 来 标 出 架构 中 的 不 同 风险 。 图 越 大 越 好 。 


步骤 2: 分 别 识别 风险 


风险 可 以 是 主观 的 ， 所 以 请 团队 中 每 个 人 (架构 师 、 开 发 者 、 项 目 经 理 、 业 务 人 等 ) 都 站 在 
架构 图 前 , 各 自 写 下 他 们 能 够 识别 的 风险 ,一 个 风险 用 一 张 便利 巾 。 此 外 ,请 他 们 根据 概率 和 影 
啊 量 化 每 个 风险 。 理 想 情况 下 ,用 不 同 颜色 的 便利 贴 来 表示 不 同 的 风险 优先 级 。 你 可 以 将 这 部 分 
练习 划分 为 5~10 分 钟 的 时 间 段 ， 以 免 拖延 ， 这 一 步 应 该 保持 沈默， 每 个 人 收 好 各 自 的 便利 贴 。 

这 里 是 一 些 要 寻找 的 风险 的 例子 : 


口 第 三 方 系统 的 数据 格式 意外 变更 ; 
口 外 部 系统 不 可 用 ; 
口 组 件 运行 过 慢 ; 


口 组 件 无 法 伸缩 ; 
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口 关键 组 件 骨 省 ; 
口 单 点 故障 ; 
口 数据 被 破坏 ; 
口 基础 设施 故障 ; 
口 磁盘 填 满 ; 
口 新 技术 未 按 预 期 工作 ; 
口 新 技术 使 用 过 于 复杂 ; 
口 等 等 。 

有 了 软件 开发 评估 , 根据 人 们 的 经 验 , 他 们 对 风险 的 看 法 可 以 是 主观 的 。 如 果 你 计划 使 用 一 
种 新 技术 , 但 愿 团 队 中 有 人 能 识别 出 相关 的 风险 。 另 外 , 有 人 可 能 会 对 使 用 新 技术 的 风险 量化 得 
比较 高 ， 而 其 他 人 如 果 已 经 用 过 同一 种 技术 ,可 能 感觉 就 不 一 样 。 各 自 识别 风险 让 每 个 人 都 可 以 
为 风险 识别 流程 作出 贡献 , 你 将 更 好 地 了 解 团队 感知 的 风险 ,而 不 仅仅 是 那些 设计 软件 或 领导 团 
队 的 人 的 看 法 。 


步骤 3: 汇总 图 中 的 风险 


接 下 来 , 请 大 家 把 自己 的 便利 贴 贴 在 架构 图 上 ， 邻近 风险 被 识别 出 的 区 域 。 举 个 例子 ,如果 
你 识别 出 一 个 组 件 会 有 运行 过 慢 的 风险 ， 就 把 便利 贴 贴 在 架构 图 中 那个 组 件 的 上 方 。 


这 种 技术 的 这 个 部 分 是 视觉 的 , 一 旦 完成 ,你 就 能 一 眼看 到 风险 最 高 的 区 域 在 哪里 。 如 果 有 
人 识别 出 类 似 的 风险 ， 随 着 大 家 想法 的 汇总 ， 图 的 上 方 会 贴 满 便利 贴 。 


汇总 图 中 的 风险 
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步骤 4: 对 风险 设 定 优先 级 
现在 你 们 可 以 拿 下 每 一 张 便利 贴 ( 或 一 堆 便 利 贴 )， 就 如 何 量化 已 识别 的 风险 达成 共识 。 


口 单 张 便利 贴 : 问 识别 出 风险 的 人 它们 的 理由 是 什么 ， 并 就 其 概率 和 影响 达成 共识 。 经 过 
讨论 ， 如 果 概 率 或 影响 是 “无 "， 就 从 架构 图 上 把 便利 贴 拿 下 来 ， 但 别 扔 掉 它 。 

口 成 堆 的 便利 贴 : 如果 每 张 便利 贴 的 概率 和 影响 都 相同 ， 那 就 完成 了 。 如 果 不 是 ， 则 需要 
用 与 规划 扑克 "或 推广 德尔 菲 法 ”环节 中 相同 的 评估 方法 ， 就 如 何 量化 风险 达成 共识 。 
看 哪些 与 众 不 同 ， 并 相应 地 了 解 人 们 量化 风险 背后 的 根据 。 


缓解 策略 

识别 与 软件 架构 相关 的 风险 是 很 重要 的 一 项 工作 , 但 你 也 需要 准备 好 缓解 策略 , 以便 从 一 开 
台 就 防止 风险 的 发 生 或 者 当 风险 已 经 发 生 时 采取 修正 措施 。 由 于 现在 已 经 为 风险 设 定 了 优先 级 ， 
你 可 以 把 精力 先 集中 在 高 优先 级 的 风险 上 。 

根据 风险 的 类 型 ， 有 一 些 适 用 的 缓解 策略 ， 包 括 下 面 这 些 。 

(1) 教育 : 训练 团队 ， 重 组 团队 ， 或 者 在 你 缺乏 经 验 的 领域 ( 比如 新 的 技术 ) 招聘 新 成 员 。 

(2) 原型 : 在 需要 通过 证 明 某 些 事 能 否 工 作 来 缓解 技术 风险 的 地 方 创建 原型 。 由 于 风险 风暴 是 
一 种 可 视 的 技术 ， 它 可 以 让 你 很 容易 地 看 到 软件 系统 中 的 可 能 应 该 结合 原型 更 详细 查看 的 部 分 。 

(3) 修订 : 改变 你 的 软件 架构 ， 以 消除 或 减少 已 识别 风险 的 概率 /影响 〈 比如 , 移 除 单 点 故障 、 
增加 一 个 缓存 以 免 受 到 第 三 方 系统 中 断 的 影响 等 ) 如 果 你 决定 改变 黑 构 ， 可 以 重新 进行 风险 风 
暴 ， 以 检验 变化 是 否 达到 预期 的 效果 。 


何 时 使 用 风险 风暴 


风险 风暴 是 一 项 快速 、 有 趣 的 技术 ， 提 供 了 一 种 识别 和 可 视 化 风险 的 协同 方法 。 另 一 方面 ， 
这 种 技术 可 用 于 任何 能 够 可 视 化 的 东西 ; 从 企业 架构 到 业务 流程 和 工作 流 。 它 可 以 在 一 个 软件 开 
发 项 目的 开始 阶段 使 用 ， 也 可 以 一 直 使 用 ,或 者 在 迭代 计划 阶段 或 回顾 中 使 用 。 


确保 你 保留 了 识别 风险 的 记录 ,包括 那些 后 来 被 认为 概率 或 影响 是 “无 ”的 。 此 外 ,何不 把 
带 有 便利 贴 的 架构 图 留 在 项 目 室 的 墙 上 , 这 样 每 个 人 都 能 看 到 这 个 额外 的 信息 层 。 要 预防 项 目 失 
败 ， 识 别 风 险 必 不 可 少 ， 如 果 让 整个 团队 都 参与 ， 它 就 不 是 一 件 珊 事 。 


GD http://planningpoker.com 
© http://en.wikipedia.org/wiki/Wideband_delphi 
@ 德尔 菲 法 是 一 种 结构 化 的 决策 支持 技术 ， 见 http://en.wikipedia.org/wiki/Delphi method。 一 一 译 者 注 
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集体 所 有 制 


关于 风险 的 最 后 一 点 是 ， 在 大 多 数 软件 项 目 中 ， 风 险 归 谁 所 有 ?以 我 的 经 验 , “风险 记录 ” 
( 如 果 有 的 话 ) 通常 归 唯 一 的 非 技术 的 项 目 经 理 所 有 。 这 有 意义 吗 ? 他 们 了 解 技术 风险 吗 ? 他们 
真 的 关心 技术 风险 吗 ? 


一 个 更 好 的 方法 是 将 技术 风险 的 所 有 权 交 给 软件 架构 角色 。 务必 保留 一 份 中 央 风 险 记录 , 但 
要 确保 团队 中 有 人 在 主动 打 理 技术 风险 ,特别 是 那些 会 导致 你 的 项 目 被 取消 或 你 被 解雇 的 。 当然， 
在 团队 中 共享 软件 架构 的 角色 也 为 风险 的 集体 所 有 制 铺 平 了 道路 。 


第 OG 章 
恰如其分 的 预先 设计 


软件 的 一 个 主要 分 歧 是 要 做 多 少 预先 设计 。 对 于 应 该 什么 时 候 做 设计 和 应 该 做 多 少 , 人 们 是 
非常 两 极 化 的 。 以 我 和 软件 团队 工作 的 经 验 ， 基 本 上 有 以 下 几 类 观点 : 


口 “在 开始 编码 之 前 ， 我 们 需要 预先 做 好 所 有 的 软件 架构 ”; 
口 “软件 架构 不 需要 预先 完成 ， 我 们 会 逐步 演化 它 ”; 
口 “ 嗯 ， 我 们 拥有 一 支 优秀 的 团队 ， 不 需要 做 软件 架构 ”。 


这 些 不 同 的 观点 引出 了 一 个 有 趣 的 问题 ， 你 需要 提前 做 多 少 架 构 ? 


回 到 方法 学 


分 此 的 一 个 主要 原因 来 自 于 团队 如 何 工作 , 具体 到 他 们 遵循 的 是 哪 种 开发 方法 学 。 如 果 从 提 
倡 多 少 预先 设计 来 对 常见 的 软件 开发 方法 进行 比较 ， 你 会 得 到 如 下 的 图 。 

一 头 是 党 布 式 ， 它 的 典型 形式 是 大 型 预先 设计 ,推崇 在 开始 编写 代码 之 前 ,每 件 事 都 必须 决 
定 、 评 审 和 签发 。 男 一头 则 是 表面 看 来 回避 架构 的 敏捷 方法 。 

可 以 说 这 一 点 不 是 真 的 。 敏捷 方法 没有 说 “不 做 架构 ”, 就 像 它们 没有 说 “不 产 出 任何 文档 ”。 
敏捷 是 充分 度 、 快 速 行动 、 拥 抱 变化 、 反 馈 和 交付 价值 。 但 因为 敏捷 方法 和 它们 的 布道 者 不 强调 


软件 开发 的 架构 层面 ， 很 多 人 都 将 其 误解 为 “人 敏 提 


E 说 不 做 任何 架构 ”"。 更 常见 的 是 ， 敏 捷 团队 选 


择 把 设计 工作 分 散 到 整个 项 目 ， 而 不 是 全 部 预先 做 。 对 此 有 几 种 说 法 ,包括 “演化 架构 ”和 “ 浮 


现 式 设 计 ”。 根 据 软件 系统 的 规模 和 复杂 度 以 及 团 
“盲目 乐观 ”。 


队 的 经 验 和 成 熟 度 ， 最 终 这 可 能 不 幸 地 演变 成 
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| 运 py 
大 型 预先 设计 浮现 次 设计 (发 者 
没有 ， 取 类 于 你 的 
视角 ) 


-nup 


Rational Unified Process* 


< 瀑布 式 | 


Atern 


| 


介 于 两 者 之 间 


So 
A 


” 
规范 黎 护 交付 |- -| ~ |> 


Scrum 


两 头 中 间 的 是 像 Rational 统一 过 程 (RUP )“”、 规 范 敏捷 交付 (DAD ) “和 动态 系统 开发 方法 


( DSDM ) Atern 这 样 的 方法 。 这 些 是 灵活 的 过 程 框架 ， 


实现 中 可 以 全 部 或 部 分 采用 。 尽 管 RUP 


实现 往往 是 与 瀑布 式 方法 有 更 多 共同 点 的 重量 级 怪物 , 它 也 可 以 缩减 规模 , 呈现 出 能 让 它 占据 中 
心地 带 的 特征 组 合 。DAD 基本 上 是 一 个 精简 版 的 RUP， 而 DSDM Atem 则 是 一 个 类 似 的 迭代 和 
增 量 方法 ,也 受到 敏捷 运动 的 影响 。 三 者 都 是 风险 驱动 的 方法 学 ， 基本 上 就 是 “集中 主要 的 高 层 
次 关键 需求 ， 规 避风 险 ， 然 后 迭代 和 增 量 "。DSDM Atern 甚至 使 用 术语 “坚实 的 基础 ”来 形容 这 
一 点 。 做 对 了 ， 这 些 方 法 就 能 在 预先 设计 和 演化 架构 之 间 达 到 良好 的 平衡 。 


要 做 到 “恰如其分 ” 


对 于 预先 架构 和 设计 ， 我 的 方法 是 要 做 到 “恰如其分 "。 如 果 你 对 人 们 这 样 说 ， 他 们 要 么 认 


为 这 是 鼓舞 人 心 的 新 鲜 空气 , 完全 符合 他 们 已 有 的 信念 


,要 么 认为 这 是 彻头彻尾 的 逃避 责任 !“ 恰 


如 其 分 ”是 一 条 准则 , 但 它 是 模糊 的 , 对 人 们 评 佑 多少 算 够 没有 太 大 帮助 。 根 据 我 对 架构 的 定义 ， 
你 可 以 说 自己 需要 做 恰如其分 的 预先 设计 来 得 到 结构 和 愿景 。 换 名 话说 , 做 到 足够 才 会 知道 自己 
的 目标 是 什么 ， 要 如 何 实现 它 。 这 是 一 条 更 好 的 准则 ， 但 仍然 没有 提供 任何 具体 的 建议 。 


QD http:/en.wikipedia.org/wiki/IBM _Rational Unified Process 
© http://en.wikipedia.org/wiki/Disciplined Agile Delivery 


© http://en.wikipedia.org/wiki/Dynamic_systems_development method 
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事实 证 明 “ 恰 如 其 分 ”的 预先 设计 很 难 量化 ， 因 此 很 多 人 根据 自己 过 去 的 经 验 ， 对 “大 少 ” 
或 “ 太 多 ”都 有 坚定 的 主张 。 这 里 总 结 的 思想 来 自我 过 去 几 年 遇 到 的 软件 开发 者 


多 少 预先 设计 是 太 少 


口 不 了 解 系 统 边界 是 什么 ， 在 哪里 。 

口 团队 中 对 “大 局 ”没有 形成 共识 。 

口 无 法 交流 整体 愿景 。 

口 团队 成 员 对 需要 做 的 事情 不 清楚 或 感到 不 适 。 

口 没有 考虑 非 功能 需求 /质量 属性 。 

口 没有 考虑 ( 现实 的 ) 环境 约束 如 何 影 响 软件 〈 比如 部 署 环境 )。 

口 没有 考虑 主要 的 风险 ， 比 如 非 功 能 需求 、 外 部 接口 等 。 

口 尚未 确认 重大 问题 及 其 答案 。 

口 没有 考虑 关注 点 分 离 、 适 当 的 抽象 层次 、 分 层 、 可 修改 性 ， 抛 点 等 。 

口 对 架构 师 要 扮演 的 角色 没有 共识 。 

口 解决 问题 的 方法 不 一 致 。 

口 团队 缺乏 控制 和 指导 。 

口 项 目 生 命 周期 中 本 应 预先 考虑 到 的 重大 架构 变化 。 

口 过 多 的 设计 选择 和 选项 ， 往 往 伴 以 团队 成 员 对 解决 方案 或 前 进 方向 的 反对 。 
口 对 于 设计 是 否 管用 的 不 确定 〈 比 如， 设计 过 程 中 没有 执行 原型 的 部 分 )。 
口 缺乏 技术 选择 〈 即 不 必要 的 延迟 )。 


多 少 预 先 设 计 是 太 多 


口 太 多 信息 〈 即 很 长 的 文档 或 信息 超载 )。 

口 在 太 多 抽象 层次 都 过 于 详细 。 

口 太 多 图 表 。 

口 在 文档 中 编写 代码 或 伪 代 码 。 

口 过 于 死板 ,缺乏 灵活 性 的 架构 。 

口 所 有 抽象 层次 的 所 有 决策 都 已 做 出 。 

口 有 着 众多 展示 了 所 有 可 能 交互 的 序列 图 的 类 层次 设计 。 

口 详细 的 实体 关系 模型 和 数据 库 的 设计 ( 比如 ， 表 、 视 图 、 存 储 过 程 和 索引 )。 
口 分 析 竣 疾 和 纠缠 于 次 要 细节 的 团队 。 

口 编码 成 了 对 团队 来 说 无 聊 而 消极 的 设计 文物 到 代码 的 简单 变换 。 
口 一 个 无 节制 的 “设计 阶段 ”( 即时 间 和 预算 )。 

口 还 未 进行 任何 编码 就 已 到 达 最 后 期 限 。 
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多 少 是 “恰如其分 ” 


上 面 很 多 答案 都 不 难得 到 认同 , 但 是 “恰如其分 ” 仍 处 于 两 个 极端 之 间 的 灰色 地 带 。 关 键 是 
架构 代表 了 重大 的 决策 , 而 衡量 重要 性 的 则 是 改变 的 成 本 。 换 句 话说, 就 是 修改 起 来 真 的 很 昂贵 ， 
也 真 的 需要 尽早 做 对 的 东西 。 举 个 例子 ， 高 性 能 、 高 可 伸缩 性 、 高 安全 性 和 高 可 用 性 等 质量 一 般 
需要 尽早 融入 基础 中 , 因为 它们 很 难 安插 到 已 有 的 代码 库 中 。 重大 的 决策 也 包括 那些 你 不 能 用 一 
个 下 午 就 轻松 完成 重 构 的 东西 ， 比 如 整体 结构 、 核 心 技 术 的 选择 、“ 架 构 ” 模 式 、 核 心 框架 等 。 


暂时 回 到 RUP， 它 使 用 了 “架构 上 重要 ”这 个 术语 ， 建 议 你 应 该 找 出 什么 可 能 对 你 的 架构 
重要 。 什 么 可 能 是 重要 的 ? 嗯 ,任何 改变 成 本 高 、 复 杂 ( 比如 玉手 的 非 功 能 需求 或 约束 ) 或 新 的 
东西 。 在 现实 中 ,如 果 你 没 把 这 些 事 做 对 ， 它 们 就 会 有 高 于 正常 风险 的 后 果 。 重 要 的 元 素 往往 也 
是 主观 的 ， 会 根据 团队 的 经 验 有 所 变化 ， 这 一 点 值得 铭记 。 


在 这 里 你 有 的 就 是 一 种 软件 开发 方法 , 它 使 你 可 以 为 了 构建 向 前 发 展 的 充分 基础 而 关注 什么 
是 有 风险 的 。 无论 什么 方法 学 , 识别 架构 上 重要 的 元 素 及 其 相应 的 风险 ,都 应 该 应 用 到 所 有 的 软 
件 项 目 。 如 果 你 需要 引入 一 个 架构 冲刺 ， 茶 些 敏捷 布道 者 会 说 “你 错 了 ”， 然 而 一 些 敏捷 项 目 已 
经 引入 了 一 个 “冲刺 零 ”来 做 这 件 事 。 我 说 ， 你 需要 做 任何 基于 你 自己 的 语 境 、 对 你 管用 的 。 


尽管 所 有 这 些 提供 了 一 些 指 导 , 然而 “多 少 才 是 恰如其分 ”这 个 问题 的 答案 却 要 “看 情况 ”， 
因为 每 个 软件 团队 都 不 一 样 。 有 些 团队 更 有 经 验 ， 有 些 需 要 更 多 指导 ; 有 些 一 直 在 一 起 工作 , 有 
些 频 繁 地 轮换 和 变动 ; 有 些 软件 系统 有 大 量 必 要 的 复杂 性 , 等 等 ,那么 你 需要 做 多 少 架构 ? 我 说 ， 
你 需要 做 到 “恰如其分 ”"， 以 便 做 到 以 下 几 点 ,不 管 软件 架构 角色 是 由 一 个 人 扮演 还 是 团队 内 共 
享 这 些 都 适用 。 


风险 愿景 


理解 主要 的 结构 元 辆 识别 和 缓解 最 高 优 创建 并 交流 团队 展 
素 ， 以 及 它们 如 何 加 先 级 的 风险 开工 作 的 愿景 
基于 架构 驱动 力 组 

5 0 


设计 并 分 解 为 容器 加 风险 风暴 和 具体 的 语 境 、 容 器 和 组 件 
和 组 件 实验 图 


刚好 够 的 预先 设计 为 软件 产 
品 及 其 交付 创造 坚实 的 基础 
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结构 


口 是 什么 : 理解 主要 的 结构 元 素 ， 以 及 它们 如 何 基 于 架构 驱动 力 组 合 在 一 起 。 
口 怎么 做 : 设计 并 分 解 为 容器 和 组 件 。 


风险 


口 是 什么 : 识别 和 缓解 最 高 优先 级 的 风险 。 
口 怎么 做 : 风险 风暴 和 具体 的 实验 ”。 


愿景 


口 是 什么 : 创建 并 交流 团队 展开 工作 的 愿景 。 
口 怎么 做 : 语 境 、 容 器 和 组 件 图 。 


这 个 软件 架构 实践 的 最 小 集合 将 为 你 提供 支撑 软件 交付 的 其 余部 分 的 坚实 基础 。 有 些 架构 通 
常 确 实 需要 预先 完成 ; 但 是 有 些 则 不 是 , 还 能 够 自然 地 演化 。 关 键 在 于 找 准 强制 性 和 演化 设计 的 
分 界线 。 


把 恰如其分 的 预先 设计 置 于 适当 的 语 境 


在 现实 中 ,你 必须 回答 “多 少 预先 设计 是 足够 的 “， 我 建议 实践 架构 一 个 软件 系统 。 找 到 或 
创建 一 个 中 小 型 软件 项 目的 场景 , 制定 一 个 很 短 的 高 层次 需求 ( 功能 和 非 功 能 ) 集合 来 描述 。 这 
可 以 是 一 个 你 已 经 参与 工作 过 的 已 有 系统 , 或 者 是 跟 你 的 领域 不 相关 的 新 东西 ， 比 如 我 在 自己 的 
培训 课程 上 用 的 金融 风险 系统 。 有 了 这 个 ,再 要 求 两 组 ( 每 组 2~3 人 ) 或 更 多 的 人 通过 选择 一 些 
技术 , 做 一 些 设计 , 绘制 一 些 用 于 交流 愿景 的 图 , 找 出 一 个 解决 方案 。 为 这 个 活动 规划 好 时 间 ( 比 
如 90 分 钟 )， 然后 主持 一 个 开放 的 评审 会 议 ， 对 每 个 解决 方案 提出 以 下 类 型 的 问题 。 


口 架构 会 管用 吗 ? 如 果 不 管用 ， 为 什么 ? 

口 所 有 关键 的 风险 都 已 被 识别 了 吗 ? 

口 架构 是 否 过 于 简单 ? 是 否 过 于 复杂 ? 

口 架构 是 否 有 效 地 交流 过 ? 

口 图 的 哪些 地 方 是 受 人 喜欢 的 ”哪些 可 以 改进 ? 
口 细节 是 否 太 多 ?细节 是 否 足 够 ? 

口 你 能 把 这 作为 起 点 交 给 你 的 团队 吗 ? 

口 控制 是 否 太 多 ?指导 是 否 不 足 ? 

口 你 对 已 做 出 或 推迟 的 技术 决策 的 程度 满意 吗 ? 


QD http:/www.agilemodeling.com/essays/agileArchitecture.htm#Provelt 
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把 这 个 练习 看 作 一 种 架构 演练 "， 不 过 你 要 进行 一 次 评审 ， 主 要 集中 在 你 所 经 历 的 过 程 以 及 
产 出 ， 而 不 仅仅 是 架构 本 身 。 记 录 你 的 发 现 ， 尝试 为 将 来 处 理 软件 设计 流程 提炼 出 一 套 指导 。 商 
定 要 深入 多 少 细节 并 包含 示例 ,商定 图 表 表 示 法 并 包含 好 的 图 表示 例 , 确定 你 自己 的 环境 中 的 通 
用 约束 ， 等 等 。 如 果 可 能 的 话 ， 记 住 这 些 指导 ,反复 练习 ， 看 看 它 如何 带 来 改变 。 通 常 一 天 足够 
进行 几 次 包含 设计 /沟通 /评审 周期 的 练习 。 

没有 一 模 一 样 的 软件 团队 。 留 出 一 天 , 在 你 自己 的 环境 中 实践 软件 的 设计 流程 ,这 会 为 你 将 
来 应 对 这 一 流程 提供 一 个 一 致 的 起 点 , 帮助 你 在 适当 的 语 境 中 摘 清 楚 究竟 什么 样 的 预先 设计 对 你 
和 你 的 团队 而 言 “ 刚 好 够 ”"。 实 践 软件 设计 流程 还 有 一 个 额外 的 好 处 ， 它 是 培训 和 指导 其 他 人 的 
好 方法 。 你 在 追求 一 个 人 人 都 能 扮演 软件 架构 角色 的 自 组 织 团 队 吗 ? 


GD http://blogs.tedneward.com/2010/06/17/Architectural+Katas.aspx 
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引入 技术 领导 力 , 一 条 小 的 软件 架构 准则 就 有 从 根本 上 帮助 软件 团队 成 功 的 巨大 潜能 。 考 虑 
到 这 一 点 , 我 们 需要 解决 的 最 后 一 个 问题 就 是 , 如 何 让 软件 团队 采用 一 个 正好 合适 的 软件 架构 方 
法 , 确保 构建 出 结构 良好 的 软件 系统 来 实现 目标 , 特别 是 各 种 复杂 的 非 功 能 需求 和 约束 。 这 个 问 
题 通常 会 变 成 ， 如 何 将 软件 架构 重新 引入 软件 团队 的 工作 方式 。 


在 我 看 来 , 软件 架构 最 大 的 问题 是 它 在 与 软件 行业 每 天 创造 的 新 事物 竞争 。 我 见 过 世界 各 地 
数 以 千 计 的 软件 开发 者 ， 以 我 的 经 验 , 他 们 当中 很 多 人 对 软件 架构 的 思考 还 不 够 。 尽 管教 材 非常 
多 ， 很 多 团队 还 是 缺乏 对 软件 架构 的 真正 认识 。 


人 们 用 于 学 习 的 时 间 和 精力 有 限 , 但 没 时 间 通 常 不 是 团队 不 理解 软件 架构 是 什么 的 原因 。 我 
以 前 担任 软件 架构 角色 时 ， 和 很 多 人 一 样 搞 不 清 读 过 的 软件 架构 书 跟 日 常 工作 到 底 有 多 大 关系 。 
这 种 缺乏 了 解 的 情况 日 益 严重 , 因为 大 多 数 软件 开发 者 并 不 定期 实践 软件 架构 。 你 在 自己 的 职 ， 
生涯 中 ， 架 构 过 多 少 软件 系统 ? 


简单 来 说 ， 即 使 所 有 软件 团队 都 思考 软件 架构 也 远 远 不 够 。 那 么 ,我们 如 何 让 软件 团队 重新 
认识 软件 架构 ? 


软件 架构 应 该 容易 理解 


作为 经 验 丰 富 的 从 业者 , 我 们 有 义务 去 教育 别人 , 但 也 要 一 步 一 步 来 。 要 记 住 , 很 多 人 在 接 
触 软 件 架构 时 可 能 都 不 了 解 过 去 的 相关 研究 。 想 想 你 看 到 和 听 到 的 关于 软件 架构 的 术语 。 你 要 怎 
么 跟 一 个 典型 的 软件 开发 者 解释 “ 逮 辑 视图 ”? 当 我 们 谈 到 “物理 视图 ”时 ， 指 的 是 代码 还 是 物 
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理 设备 ?在 我 们 开始 谈论 架构 描述 语言 "和 评估 方法 "之 前 , 开发 团队 中 的 每 个 人 都 要 了 解 软件 架 
构 的 本 质 以 及 不 思考 它 的 后 果 。 软 件 架 构 的 信息 要 具备 可 用 性 ， 立 足 现 实 。 


这 么 说 似乎 很 怪 , 但 管理 软件 团队 的 人 也 需要 理解 软件 架构 的 本 质 和 必要 性 。 这 些 年 来 , 我 
合作 过 的 一 些 团队 的 管理 层 会 对 团队 说 “ 别 做 软件 架构 了 ， 赶 紧 写 代 码 ”。 这 种 情况 很 多 时 候 都 
源 于 一 个 误解 : 采用 了 敏捷 方法 ,所 有 预先 设计 的 做 法 就 都 应 该 被 气 弃 。 这 些 软件 开发 团队 通常 
承受 着 极 大 的 交付 压力 ， 但 一 些 预先 思考 不 但 不 会 成 为 阻碍 ， 反 而 是 有 益 的 。 


一 些 实用 的 建议 

下 面 是 一 些 向 初学 者 介绍 软件 架构 的 实用 建议 。 

1. 宣传 教育 

举办 几 次 专题 研讨 活动 , 帮助 人 们 学 习 和 理解 软件 架构 是 什么 。 可 以 针对 开发 者 或 非 开发 者 ， 
这 有 助 于 确保 所 有 人 都 有 相同 认识 。 至 少 ， 你 应 该 留意 下 面 几 点 : 


口 软件 架构 是 什么 ; 
口 软件 架构 为 什么 重要 ; 
口 你 打算 采取 的 做 法 。 


2. 回顾 架构 


如 果 你 定期 回顾 反思 你 的 团队 执行 情况 , 为 什么 不 直接 在 谈话 的 主题 列表 上 加 入 软件 架构 ? 
如 果 你 认为 软件 架构 没有 得 到 足够 重视 , 也 许 是 因为 你 经 常 重 构 你 的 软件 架构 , 或 者 在 一 些 非 功 
能 特性 上 遇 到 了 问题 , 那么 思考 一 下 你 可 以 采用 的 软件 架构 实践 。 男 一 方面 ， 如 果 你 花 太 多 时 间 
思考 软件 架构 或 预先 设计 , 也 许 是 时 候 看 看 这 个 工作 的 价值 , 以 及 是 否 有 任何 实践 可 以 被 放弃 或 
取代 。 


3. 完成 标准 


如 果 你 对 工作 项 目 有 “完成 标准 ”， 把 软件 架构 也 加 进去 。 这 有 助 于 确保 你 以 任何 所 需 的 架 
构 模 式 、 规 则 或 非 功能 目标 来 考虑 工作 项 目 架构 的 影响 和 实现 的 一 致 性 。 


4. 分 配 软 件 架构 角色 


如 果 你 的 软件 团队 不 思考 软件 架构 , 那么 简单 地 把 软件 架构 角色 分 配给 团队 内 某 个 可 能 合适 
的 人 选 也 许可 行 , 因为 你 明确 地 把 对 软件 架构 的 所 有 权 和 责任 指定 给 了 一 个 人 。 把 这 个 角色 分 配 


GD http://en.wikipedia.org/wiki/Architecture_description language 
© http://www.sei.cmu.edu/architecture/tools/evaluate/ 


第 66 章 ， 初 识 软件 架构 181 


给 多 人 在 有 些 团 队 里 行 得 通 , 但 我 发 现 , 起 初 由 一 个 人 承担 ,然后 随 着 团队 经 验 的 增加 ， 再 与 
他 人 共享 ， 这 种 方式 更 好 。 有 些 团队 不 喜欢 “软件 架构 师 ” 这 个 词 ， 而 代 之 以 架构 所 有 者 "。 不 
管 你 怎么 称呼 它 ， 指 导 和 合作 才 是 关键 。 


5. 架构 培训 班 


光 说 还 不 够 , 怀疑 论 者 要 看 的 是 架构 并 非 大 型 预先 设计 。 这 也 是 我 举办 短期 架构 培训 班 的 原 
因 , 一 些小 团队 可 以 协作 为 一 组 简单 的 需求 架构 软件 解决 方案 , 制作 数 个 可 视 化 图 表 , 并 互相 交 
流 各 自 的 方案 。 这 让 人 们 体会 到 预先 设计 并 不 一 定 意味 着 在 非常 低 的 抽象 层次 设计 好 所 有 东西 ， 
也 提供 了 一 种 实践 沟通 软件 架构 的 方法 。 


推动 变革 发 生 
对 那些 明白 软件 架构 很 好 ， 却 不 知道 如 何 将 其 引入 项 目的 人 而 言 ， 有 一 个 比较 常见 的 问题 ; 


“我 理解 对 软件 架构 的 需要 ， 但 我 们 的 团队 没有 时 间 实 施 ， 因 为 大 家 都 忙于 为 项 目 
编码 。 话 虽 如 此 ， 我 们 没有 一 致 的 解决 问题 的 方法 ， 诸 如 此 类 。 我 们 的 经 理 也 不 会 给 我 
们 时 间 做 架构 。 做 架构 ， 就 没 法 编码 。 该 怎么 引入 架构 ? ” 


为 了 理解 软件 架构 对 主动 思考 的 需要 ， 有 几 个 问题 值得 一 问 。 


(D 缺乏 软件 架构 造成 了 哪些 问题 ? 
(2) 缺乏 软件 架构 在 将 来 可 能 造成 哪些 问题 ? 

(3) 这 些 问题 是 否 有 引发 更 多 严重 的 后 果 ( 比如 失去 声望 、 业务、 客户 、 收 入 , 等 等 ) 的 风险 ? 
(4) 哪些 事 已 经 做 错 了 ? 


有 一 件 事 我 会 告诉 刚 接触 架构 角色 的 人 们 , 他 们 确实 需要 专门 花 一 些 时 间 在 架构 工作 (大 局 
的 事务 ) 上 , 但 要 与 日 常 开发 工作 之 间 找 到 一 个 平衡 。 如 果 你 所 有 时 间 都 用 来 编码 ， 就 做 不 了 架 
构 。 男 一 方面 ,“ 软 件 架构 ” 花 太 多 时 间 意 味 着 你 没 写 什么 代码 ， 可 我 们 都 知道 漂亮 的 图 表 对 最 
终 用 户 毫 无 用 处 ! 


“我 们 该 如 何 引 入 软件 架构 ”这 类 问题 没有 一 个 简单 的 答案 , 因为 它 要 求 软件 团队 改变 工作 方 
式 ， 只 有 当 你 完全 了 解 团队 的 情况 , 才 有 可 能 。 一 般 来 讲 , 团队 改变 工作 方式 大 致 可 以 分 为 两 类 。 


被 动 型 : 大 多 数 团 队 只 会 在 情况 变 精 的 时 候 改 变 工作 方式 。 换 名 话说， 当 且 仅 当 有 诱因 时 ， 
他 们 才 会 改变 。 诱因 可 能 是 失败 的 系统 部 署 过 程 中 的 任何 事 , 或 者 严重 系统 故障 之 类 的 事情 。 在 
这 种 情况 下 ,他 们 知道 有 些 事 不 太 对 ,可 能 因为 管理 层 让 他 们 日 子 不 好 过 , 他们 也 知道 必须 有 所 
行动 ， 改 变 这 种 状况 。 可 惜 ， 这 种 方式 在 软件 行业 里 占 了 大 多 数 。 


y 


~ 


QD http:/www.agilemodeling.com/essays/architectureOwner.htm 


182 程序 员 必 读 之 软件 架构 


主动 型 : 有 些 团 队 则 积极 地 改进 工作 方式 。 即 使 没有 发 生 什么 坏事 ,他 们 也 能 看 到 改进 的 空 
间 , 防止 陷入 上 面 提 到 的 状况 。 讽 刺 的 是 ,这些 团队 往往 很 优秀 ， 并 不 需要 改变 , 但 他 们 非常 清 
楚 持 续 改进 带 来 的 好 处 。 


回 到 原来 的 问题 , 团队 确实 想 花 一 些 时 间 在 架构 上 , 但 并 没有 得 到 管理 层 的 认可 。 也 许 管理 
层 并 没有 清楚 认识 到 这 样 做 的 好 处 或 者 不 这 样 做 的 后 果 。 无 论 怎 样 , 团队 都 没有 得 到 期 望 的 结果 。 
每 当 我 自己 处 于 这 种 情况 时 ， 我 会 采取 以 下 两 种 方法 之 一 。 


以 非常 清晰 和 简洁 的 方式 陈述 当前 的 状况 ， 如 果 不 做 出 改变 ， 会 有 哪些 问题 、 风 险 和 后 果 。 
通常 你 会 向 主要 决策 者 、 项 目 资助 人 或 管理 层 陈述 这 些 内 容 。 一 旦 他 们 了 解 了 风险 , 就 能 够 判断 ， 
是 否 值得 为 降低 风险 付出 改变 行为 所 需 的 精力 。 这 要 求 很 娴熟 的 技巧 ， 有 时 候 也 未 必 被 接受 , 特 
别 是 刚 接触 到 一 个 你 觉得 不 正常 的 团队 。 


以 身 作 则 ,发 现 并 解决 问题 ， 包 括 缺 乏 技术 文档 、 解 决 问题 的 方法 不 一 致 、 架 构 层 过 多 、 不 
一 致 的 组 件 配置 等 。 有 时 候 , 在 所 有 人 了 解 付出 精力 得 到 的 回报 之 前 , 最 初 改 变 的 种 子 就 要 到 位 ， 
有 点 像 大 多 数 人 第 一 次 看 到 自动 化 单元 测试 时 的 反应 。 


每 种 方法 都 有 各 自 适用 的 情况 ,这 取决 于 很 多 因素 。 回 到 原来 的 问题 ， 有 可 能 使 用 了 最 合适 
的 方法 , 但 要 么 消息 很 弱 , 要 么 管理 层 不 认为 值得 花 这 个 钱 去 降低 没有 专门 “架构 时 间 ” 的 风险 。 
对 于 这 种 情况 ,我 会 以 积极 主动 、 以 身 作 则 的 姿态 引入 软件 架构 。 只 要 找到 并 修复 一 个 问题 〈 比 
如 多 种 配置 方法 ， 没 有 高 层次 文档 ， 混 乱 的 组 件 结构 ， 等 等 )。 我 不 是 说 要 放下 工具 停工 几 个 星 
期 ， 因 为 我 们 都 知道 ， 想 要 说 服 管理 层 同意 花 三 个 月 来 重 构 太 困难 了 。 我 的 意思 是 ， 分 解 问题 逐 
个 击破 , 一 步 步 改变 处 境 。 每 天 花 几 分 钟 在 这 类 任务 上 , 在 你 意识 到 之 前 , 可 能 已 经 有 所 改观 了 。 
“请 求 原谅 比 得 到 许可 更 容易 ”。 


Wy 


软件 架构 的 本 质 


很 多 软件 团队 都 已 经 在 使 用 敏捷 和 精益 方法 , 更 多 的 团队 在 朝 这 个 方向 走 。 因 此 , 团队 采用 
任何 软件 架构 实践 都 应 该 产 出 真正 的 价值 , 否则 就 只 是 在 浪费 时 间 和 精力 。 只 有 你 能 决定 多 少 软 
件 架 构 才 合适 ， 也 只 有 你 能 决定 如 何 最 好 地 引导 出 你 想 在 团队 中 看 到 的 变化 。 祝 你 好 运 ! 


(1) 不 管 敏捷 方法 被 宣传 成 什么 样 , “敏捷 ”和 “架构 ” 真 的 水 火 不容 吗 ? 

(2) 如 果 你 正在 一 个 敏捷 软件 团队 中 工作 ， 你 们 考虑 过 架构 吗 ? 

(3) 你 是 否认 为 自己 在 目前 的 软件 开发 团队 中 有 足够 的 技术 领导 力 ? 如 果 是 ， 为 什么 ?如 果 
不 是 ， 又 是 为 什么 ? 

(4) 多 少 预 先 设计 才 足 够 ” 该 如 何 适可而止 ? 整个 团队 是 否 都 了 解 并 理解 这 一 观点 ? 

(5) 很 多 软件 开发 者 参加 编码 培训 班 来 磨 练 自己 的 技能 。 你 将 如 何 提升 自己 的 软件 架构 技 
能 ? 〈 比 如， 根据 某 些 需求 ， 在 一 张 白 纸 上 完 成 软件 的 方案 设计 ) 

(6) 什么 是 风险 ? 所 有 的 风险 都 等 同 吗 ? 

(7) 在 你 的 团队 里 ， 由 谁 来 识别 技术 风险 ? 

(8) 在 你 的 团队 中 ， 由 谁 打 理 技术 风险 ”如 果 让 (通常 是 非 技 术 的 ) 项 目 经 理 或 流程 经 理 来 ， 
会 是 个 好 主意 吗 ? 

(9) 当 你 忽视 技术 风险 时 ， 会 发 生 什么 ? 

(10) 面 对 风 险 ， 你 能 主动 做 些 什么 ? 

(11) 需要 在 你 团队 的 工作 方式 中 引入 软件 架构 吗 ? 如 果 是 ， 你 会 怎么 做 ? 


我 们 在 这 部 分 学 习 本 书 中 一 直 提 及 的 和 


融 风 险 系 


统 案例 。 在 我 的 “面向 开发 者 的 软件 架 枸 * 


“培训 课程 


和 “敏捷 软件 架构 草图 ”专题 研讨 中 也 用 到 了 它 。 


x 
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第 GOO 章 
金融 风险 系统 


背景 

一 家 位 于 伦敦 、 纽 约 和 新 加 坡 的 全 球 投资 银行 和 其 他 银行 ( 交易 对 手 ) 进行 金融 产品 的 交易 
〈 买 和 卖 )。 随 着 股票 市 场 上 的 股票 价格 上 涨 或 下 跌 ， 银 行 要 么 赚钱 要 么 赔钱 。 在 工作 日 结束 时 ， 
银行 需要 对 他 们 的 交易 数据 运行 一 些 计算 ， 获 知 他 们 面临 多 大 的 风险 〈 比如 赔钱 ) 银行 有 现成 
的 交易 数据 系统 (TDS ) 和 参考 数据 系统 (RDS )， 但 还 需要 一 个 新 的 风险 系统 。 


交易 数据 系统 


交易 数据 系统 存储 了 银行 进行 的 所 有 交易 。 它 已 经 配置 为 在 纽约 的 交易 关闭 时 间 ( 下 午 5 点 ) 
生成 一 个 XML 输出 文件 。 输 出 包括 银行 进行 的 每 一 次 交易 的 以 下 信息 : 


口 交易 ID ; 

D 日 期 ; 

口 当前 的 美元 交易 价格 ; 
口 交易 对 手 ID。 


参考 数据 系统 


参考 数据 系统 维护 了 银行 需要 的 所 有 参考 数据 。 这 包括 了 交易 对 手 的 信息 , 每 一 个 都 代表 一 
个 个 体 、 一 家 银行 等 。 它 也 生成 XML 输出 文件 ， 包 括 了 每 个 交易 对 手 的 基本 信息 。 一 个 新 的 全 
组 织 参考 数据 系统 将 在 未 来 3 个 月 内 完工 ， 而 当前 的 系统 最 终 将 停 用 。 
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以 下 是 新 的 风险 系统 的 高 层次 功能 需求 : 


(1) 从 交易 数据 系统 导入 交易 数据 ; 

(2) 从 参考 数据 系统 导入 交易 对 手数 据 ; 

(3) 合并 两 个 数据 集 ， 用 交易 对 手 的 信息 丰富 交易 数据 ; 

(4) 对 每 个 交易 对 手 计算 银行 面临 的 风险 ; 

(5) 生成 一 个 可 以 导入 微软 Excel 的 报表 ,包含 银行 所 有 已 知 的 交易 对 手 的 风险 指数 ; 
(6) 在 新 加 坡 的 下 一 个 交易 日 开始 (上午 9 点 ) 之 前 将 报表 分 发 给 业务 用 户 ; 

(7) 为 业务 用 户 子 集 提供 一 种 配置 和 维护 风险 计算 使 用 的 外 部 参数 的 方法 。 


非 功能 需求 
以 下 是 新 的 风险 系统 的 非 功能 需求 。 


口 新 加 坡 在 每 个 业务 日 的 当地 时 间 上 午 9 点 开 市 ， 风 险 报 表 必 须 在 此 前 生成 。 


可 伸缩 性 


口 系统 必须 有 能 力 处 理 未 来 5 年 的 交易 量 。 

口 交易 数据 系统 的 导出 文件 包括 大 约 5000 次 交易 ， 预 计 现 在 每 天 将 有 10 次 额外 的 交易 。 
口 参考 数据 系统 的 交易 对 手 导出 文件 包括 大 约 2 万 个 交易 对 手 ， 增 长 可 以 忽略 不 计 。 

口 全 世界 有 40~50 个 业务 用 户 需 要 访问 报表 。 


可 用 性 
口 风险 报表 应 该 随时 对 用 户 可 用 ， 但 少量 的 停机 ( 每 天 不 超过 30 分 钟 ) 是 可 以 忍受 的 。 


故障 转移 

口 人 工 故障 转移 对 所 有 的 系统 组 件 都 足够 了 ， 能 够 满足 可 用 性 目标 。 
安全 性 

口 这 个 系统 必须 遵循 仅 限 认证 和 授权 用 户 访问 的 银行 政策 。 


188 程序 员 必 读 之 软件 架构 


口 报表 必须 只 分 发 给 授权 用 户 。 

口 只 允许 授权 用 户 的 子 集 修改 风险 计算 使 用 的 参数 。 

尽管 也 不 错 ， 但 没有 单 点 登录 的 需求 〈( 比 如， 与 ActiveDirectory、LDAP 等 的 整 
口 所 有 对 系统 和 报表 的 访问 都 将 在 银行 的 全 球 网 络 范围 内 。 


审计 
D 以 下 事件 必须 记录 在 系统 审计 日 志 中 : 


和 牛 成 报表 ; 
日 修改 风险 计算 参数 。 


口 用 于 风险 计算 的 输入 数据 必须 是 可 理解 的 。 


容错 和 恢复 


口 如 果 可 能 ， 系 统 应 采取 适当 的 步 又 从 错误 中 恢复 ， 但 所 有 的 错误 都 应 被 记录 。 
口 影响 完成 交易 对 手 风 险 计算 的 错误 都 应 被 记录 ， 流 程 应 继续 。 


国际 化 和 本 地 化 


口 所 有 用 户 界 面 都 将 只 用 英语 呈现 。 
口 所 有 报表 都 将 只 用 英语 呈现 。 
口 所 有 交易 价格 和 风险 指数 都 将 只 用 美元 呈现 。 


监测 和 管理 
D 如 遇 下列 情 况 ， 简 单 网 络 管理 协议 (SNMP ) 陷阱 应 被 发 送 至 银行 的 中 心 监测 服务 


系统 组 件 的 致命 错误 ; 
时 新 加 坡 时 间 上 午 9 点 前 未 能 生成 报表 。 


数据 保存 和 归档 
D 风险 计算 过 程 使 用 的 输入 文件 必须 保留 1 年 。 


互 操 作 性 
口 现 有 数据 系统 的 接口 应 该 遵守 并 使 用 现 有 的 数据 格式 。 


合 )。 


附录 : “技术 部 落 ” 的 软件 指南 


这 是 “技术 部 落 ” 网 站 的 软件 指南 样本 ， 这 个 网 
站 是 我 的 一 个 分 支 项 目 ， 为 泽 西 岛 提供 一 个 技术 、T 


和 和 数字 视 域 的 焦点 。 


] GitHub Be 


“技术 部 落 ” 网 站 的 代码 已 经 开源 , 可 访 i 
获取 。 
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介绍 


该 软件 指南 提供 了 “技术 部 落 ” 网 站 的 概览 ， 包 括 对 以 下 内 容 的 总 结 : 


(1) 网 站 背后 的 需求 、 约 束 和 原则 ; 

(2) 软件 架构 ， 包 括 高 层次 的 技术 选择 和 软件 的 结构 ; 
(3) 基础 设施 架构 以 及 软件 如 何 部 署 ; 

(4) 网 站 的 运营 和 支持 方面 。 


语 境 

“技术 部 落 ” 网 站 为 在 泽 西 岛 和 格 恩 西 岛 寻找 与 技术 、IT 和 数字 领域 相关 的 人 、 部 落 ( 业务 、 
社区 、 兴 趣 组 等 ) 和 内 容 提供 了 一 个 途径 。 在 最 基本 的 层面 上 ， 它 是 一 个 本 地 的 微 博 、 新 闻 、 博 
文 、 活 动 、 讲 座 、 工 作 以 及 更 多 东西 的 内 容 聚 合 器 。 这 是 一 个 提供 可 视 化 总 结 的 语 境 图 : 

该 网 站 的 目的 : 


(1) 聚合 和 分 享 本 地 的 内 容 ， 帮 助 其 在 本 地 社区 内 外 的 推广 ; 
(2) 在 本 地 社区 促进 开放 、 分 享 和 学 习 的 文化 。 
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多 外 入 


匿名 用 户 认证 用 户 (通过 管理 用 户 (通过 
Twitter ID 登 录 ) [witter ID 登录 ) 


管理 用 户 信息 
和 部 落成 员 


查看 本 地 的 技术 、 数 字 和 IT 领域 

的 人 、 部 落 (业务 、 社 区 、 兴 趣 

组 ) 、 内 容 、 活 动 、 工 作 等 添加 人 ， 添 加 部 落 
以 及 管理 部 落成 员 


techtribes.je 


获取 配置 信 获取 RSS 和 Atom 
息 和 微 博 订阅 的 内 容 
获取 代码 仓库 信息 
1 << 外 部 系统 >> ， 过 < 外 部 系统 >> a << 外 部 系统 >> a 
Twitter GitHub ' 博客 和 


a | 
4 


e000000 eo-eo。=。0。07 


技术 部 沙 - 语 境 


下 


用 户 
“技术 部 落 ” 网 站 有 三 类 用 户 。 
(1) 匿名 用 户 : 任何 人 都 可 以 通过 Web 浏览 器 查看 站 点 上 的 内 容 。 
(2) 认证 用 户 : 有 内 容 被 聚合 到 网 站 的 人 /部 落 可 以 用 他 们 注册 的 Twitter ID ( 如 果 有 的 话 ) 登 


入 网 站 ， 修 改 他 们 的 基本 档案 信息 。 
(3) 管理 用 户 : 拥有 网 站 管理 ( 超级 用 户 ) 权限 的 人 可 以 管理 网 站 聚合 的 人 、 部 落 和 内 容 。 


外 部 系统 
“技术 部 落 ” 集 成 了 三 种 类 型 的 系统 ， 在 语 境 图 上 用 灰色 虚线 框 代表 。 
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(1) Twitter: 从 Twitter 取 回 人 /部 落 的 档案 信息 和 微 博 ， 聚 合 到 网 站 。Twitter 也 用 来 让 人 /部 
落 通 过 他 们 的 Twitter ID 登入“ 技术 部 落 ”。 

(2) GitHub: 如 果 人 /部 落 注册 过 GitHub 的 ID ， 就 会 从 GitHub 取 回 代码 仓库 的 总 结 信息 。 

(3) 博客 : 通过 RSS 或 Atom 订阅 取 回 人 /部 落 写 的 博客 的 内 容 ， 聚 合 到 网 站 。 


功能 性 概览 
这 个 部 分 对 “技术 部 落 ” 网 站 提供 的 功能 进行 了 一 个 总 结 。 


人 和 部 落 
“技术 部 落 ” 的 核心 是 人 和 部 落 。 
口 人 : 本 地 的 技术 、 数 字 和 IT 领域 内 的 人 。 
口 部 落 : 一 个 部 落 就 是 一 群 人 。 分 4 种 类 型 。 
和 业务 : 一 个 业务 部 落 代 表 一 个 本 地 公司 。 
和 技术 : 一 个 技术 部 落 是 对 一 个 特定 话题 ( 比如 ，Java、 树 区 派 、SharePoint 等 ) 有 共同 
兴趣 的 一 群 人 。 


媒体: 一 个 媒体 部 落 是 一 个 发 布 本 地 新 闻 的 组 织 。 
ma 社区 : 一 个 社区 部 落 代表 一 个 本 地 用 户 群 或 其 他 非 鳃 利 性 组 织 。 


人 和 部 落 有 一 些 基本 档案 信息 ， 以 及 一 个 Twitter ID 和 “技术 部 落 ” 用 来 把 内 容 聚 合 到 网 站 
的 一 个 或 多 个 RSS/Atom 订阅 链接 。 


“技术 部 落 ” 聚 合 和 发 布 多 种 不 同类 型 的 内 容 ， 都 和 人 或 部 落 相 关 。 
博文 和 微 博 


“技术 部 落 ” 的 主要 功能 是 聚合 人 和 部 落 的 博文 和 微 博 ， 使 网 站 的 用 户 可 以 在 一 个 地 方 找到 
那些 内 容 。 博 文 和 微 博 可 以 在 网 站 上 以 多 种 方式 查看 ， 此 外 还 提供 了 搜索 功能 。 网 站 也 发 布 了 一 
个 所 有 博文 的 统一 RSS 订阅 。 


新 闻 

本 地 技术 新 闻 条 目 就 是 媒体 部 落 的 博文 。 此 外 ， 这 些 可 以 在 网 站 上 以 多 种 方式 查看 。 

讲座 

“技术 部 落 ” 发 布 本 地 人 在 会 议 、 聚 会 和 其 他 活动 上 的 各 种 讲座 。 每 个 讲座 有 一 些 基本 信息 
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( 即 ， 标 题 、 摘 要 、 日 期 ,再 加 上 活动 细节 )， 并 关联 到 一 个 人 。 

活动 

“技术 部 落 ” 还 发 布 本 地 的 技术 活动 、 聚 会 、 用 户 组 等 信息 。 每 个 活动 有 一 些 基 本 信息 ( 即 ， 
标题 、 描 述 、 日 期 、 时 间 、 活 动 链接 等 )， 并 关联 到 一 个 部 落 。 

工作 


最 后 , “技术 部 落 ” 列 出 了 本 地 的 技术 工作 。 每 个 工作 有 一 些 基 本 信息 ( 即 ， 标 题 、 描 述 、 
发 布 日 期 、 更 多 信息 的 链接 等 )， 也 关联 到 一 个 部 落 。 


用 户 
有 三 种 类 型 的 用 户 。 
匿名 用 户 
匿名 用 户 代 表 了 任何 访问 “技术 部 落 ” 的 人 ， 他 们 能 够 以 多 种 方式 查看 网 站 上 的 所 有 内 容 。 
认证 用 户 


列 在 “技术 部 落 ” 上 的 本 地 人 能 够 用 他 们 的 Twitter ID 登入 ， 以 便 管理 一 些 基 本 档案 信息 和 
他 们 加 入 的 技术 部 落 的 清单 。 


管理 用 户 


管理 用 户 是 一 些 认证 用 户 ， 有 权 运 行 网 站 的 一 些 基 本 管理 功能 ,包括 向 网 站 添加 人 和 部 落 ， 
以 及 管理 部 落成 员 。 


博弈 引擎 


“技术 部 落 ” 提 供 的 最 后 一 个 主要 功能 是 一 个 简单 的 博弈 引擎 ， 或 励 本 地 人 和 部 落 与 社区 的 
其 他 成 员 接触 ， 更 经 常 地 分 享 内 容 。 


分 数 

人 和 部 落 发 表 微 博 、 博 文 ， 进 行 讲座 和 组 织 活动 ， 可 以 得 到 奖励 分 数 。 根 据 最 近 七 天 的 分 数 
可 以 滚动 计算 出 最 活路 排行 榜 。 

徽章 

除了 分 数 ,徽章 也 会 奖励 给 获得 特定 成 就 的 人 和 部 落 。 这 包括 从 发 表 推 文 和 微 博 等 简单 的 事 ， 
到 进入 最 活跃 排行 榜 前 三 位 ， 在 岛 外 进行 讲座 。 
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质量 属性 
这 个 部 分 提供 “技术 部 落 ” 网 站 所 需 的 质量 属性 ( 非 功 能 需求 ) 的 信息 。 


对 于 50 个 当前 用 户 ,“ 技 术 部 落 ” 所 有 的 页 面 都 应 该 在 5 秒 内 加 载 和 泻 染 。 


可 伸缩 性 
“技术 部 落 ” 网 站 应 该 能 够 伸缩 到 当前 数据 量 的 十 倍 。 如 下 : 


口 1000 个 人 和 部 落 ; 
口 50 万 条 微 博 ; 
口 1 万 条 新 闻 / 博 文 。 


安全 性 


尽管 匿名 用 户 可 以 查看 “技术 部 落 ” 网 站 的 大 部 分 内 容 ,还 是 必须 提供 基于 角色 的 访问 ， 人 允 
许 人 /部 落 登 入 并 管理 他 们 的 档案 。 为 了 降低 管理 用 户 和 凭据 相 关 的 运营 支持 开销 ， 所 有 认证 必须 
通过 Twitter 、Facebook 、Google 、OpenID 等 第 三 方 机 制 实 现 。 


可 用 性 
因为 “技术 部 落 ” 系 统 不 是 一 个 关键 的 任务 ， 预 算 有 限 ， 所 以 并 没有 严格 的 可 用 性 目标 。 


国际 化 

所 有 用 户 界面 文字 只 用 英语 呈现 。 
本 地 化 

所 有 信息 都 只 使 用 英国 英语 的 格式 。 
浏览 器 兼容 性 

“技术 部 落 ” 网 站 应 该 在 以 下 浏览 器 中 表现 一 致 : 


口 Safari; 
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口 Firefox; 
D Chrome ; 
口 Internet Explorer 8 ( 及 以 上 )。 


约束 
这 个 部 分 提供 “技术 部 落 ” 网 站 开发 中 强加 的 约束 的 信息 。 


预算 


因为 “技术 部 落 ” 网 站 没有 正式 的 预算 ， 所 以 使 用 免费 和 开源 技术 是 开发 中 的 一 个 约束 。 理 
论 上 ， 网 站 应 该 运行 在 托管 成 本 低 于 20 英镑 每 月 的 单个 服务 器 上 。 


原则 
这 个 部 分 提供 “技术 部 落 ” 网 站 开发 中 采用 的 原则 的 信息 。 


组 件 封装 


为 了 提供 一 个 简单 的 从 软件 架构 到 代码 的 映射 , 代码 的 封装 结构 反映 了 “组 件 封装 ”的 规约 ， 
而 不 是 “ 层 封装”。 


这 意味 着 把 代码 库 划分 为 多 个 组 件 ， 每 个 组 件 有 : 


口 一 个 定义 好 的 公开 接口 ; 
口 强 隔离 ( 即 所 有 实现 细节 都 尽 可 能 封装 保护 ); 
口 名 为 components.xml 的 Spring 配置 文件 来 进行 配置 和 将 组 件 接 入 系统 其 他 部 分 。 
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je.techtribes.service 
Am 


je.techtribes.component.tweet 
<< 接 口 >> 
TweetComponent 


TweetComponentimpl! 


A 


DefaultTweetService 
1 


组 件 往往 是 不 同 层 
中 的 多 个 类 的 组 合 


<< 使 用 >> 
Y 


MongoDBTweetDao 


层 封 装 


自动 化 测试 
自动 化 测试 策略 是 进行 自动 化 的 单元 和 组 件 测试 。 
口 单元 测试 : 这 些 是 对 单个 类 或 孤立 方法 执行 的 运行 快速 ， 非 常 小 的 测试 。 示 例 请 看 
techtribes-core 的 单元 测试 ?。 
口 组 件 测试 : 为 避免 破坏 隔离 ， 组 件 作为 单一 单元 来 测试 ， 而 不 是 仿造 数据 库 连 接 来 对 组 
件 内 部 进行 测试 。 示 例 请 看 techtribes-core 的 组 件 测 试 ”。 


配置 


组 件 所 需 的 全 部 配置 都 放 到 外 部 的 Java properties 文件 中 ， 存 放 在 部 署 文 件 之 外 ， 由 构建 流 
程 创建 。 这 意味 着 构建 版 本 无 需 修 改 就 能 从 开发 、 测 试 迁移 到 生产 环境 。 


Spring 自动 装配 


只 在 “技术 部 落 ” 的 Web 层 部 分 (techtribes-web”) 使 用 Spring 自动 装配 ,将 组 件 注入 到 Spring 
MVC 控制 器 。 


QD https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/test/unit 
©® https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/test/component 
© https://github.com/techtribesje/techtribesje/tree/master/techtribes-web 
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软件 架构 


这 个 部 分 提供 “技术 部 落 ” 


下 图 展示 了 组 成 “技术 部 落 ' 


息 请 看 基础 设施 和 部 署 部 分 。 


的 软件 架构 概览 。 


”系统 的 逻辑 容 需 。 


图 并 不 代表 容器 的 实际 数量 和 位 置 : 这 个 信 


匿名 用 户 认证 用 户 管理 用 户 
IHTTP] WE [HTTP] 
<< 容 器 >> 
Web 服 务 器 
查看 本 地 的 技术 、 数 字 
和 IT 领域 的 人 、 部 落 、 
内 容 、 事 件 、 工 作 等 。 
六 | XX 时 
从 [SQL/JDBC 3306 读 取 从 [MongoDB 有 线 协议 
端口 ] 读 写 数据 “，” 芭 ”“ 27017 端 口 ] 读 写 数据 
PA 
<< 容 器 >> << 容 器 >> << 容 器 >> 
关系 型 数据 库 文件 系统 NoSQL 数 据 存储 
人 、 部 落 、 部 落成 员 、 查找 索引 来 自 (博客 文章 的 ) 
交谈 、 事 件 、 工 作 、 RSS/Atom 订 阅 和 微 
徽章 、GitHub 仓 库 等 博 的 内 容 
K 和 A 
从 [SQL/JDBC3306 ,| 大 从 [MongoDB 有 线 协议 
端口 ] 读 写 数据 | 27017 端 口 ] 读 写 数据 
<<< 容 器 >> 
内 容 更 新 器 
独立 的 Java 7 进程 ** 
按 计划 更 新 配置 、 微 
博 、GitHub 仓 库 和 内 
从 
从 [HTTP] 获 取 数 据 从 [HTTP] 获 取 数 据 
技术 部 落 ”- 系 统 边界 从 [HTTP] 获 取 数 据 
，<<< 外 部 系统 >>， << 外 部 系统 >>，， ，<< 外 部 系统 >>， 
' Twitter ’. 0 GitHub 6 ' Blogs 3 


S02- 


口 Web 服务 器 : 
问 点 。 


一 


“技术 部 落 ”-- 容 器 


Apache Tomcat 7 Web 服务 器 ， 从 互联 网 访问 “技术 部 落 ” 网 站 的 单一 访 
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口 内 容 更 新 器 : 从 Twitter、GitHub 和 博客 更 新 信息 的 独立 的 Java 7 应 用 程序 。 
口 关系 型 数据 库 : 存储 了 “技术 部 落 ” 网 站 背后 大 部 分 数据 的 MySQL 数据 库 。 
口 NoSQL 数据 存储 : 存储 微 博 和 博文 的 MongoDB 数据 库 。 


口 文件 系统 : 文件 系统 存储 了 Lucene 搜索 索引 。 


组 件 : 内 容 更 新 器 
下 图 展示 了 组 成 独立 的 内 容 更 新 器 的 组 件 。 


<< 容 器 >> < < 容器 >> < < 容器 > 之 > 
关系 型 数据 库 文件 系统 NoSQL 数 据 存储 
读 取 及 写 入 更 新 的 数据 
“技术 部 洲 " 
内 容 更 新 器 “技术 部 落 ” 核 心 组 件 (在 另 一 
张 单独 的 图 中 展示 ) 
fin 
<< 组 件 >> 
计划 内 容 更 新 器 
Spring 计 划 任务 


从 外 部 系统 刷新 
信息 


i 使 用 和 
2 


<< 组 件 >> << 组 件 >> << 组 件 >> 
Twitter 连接 器 GitHub 连 接 器 新 闻 订 阅 连 接 器 
提取 资料 信息 和 从 RSS 和 Atom 订 
推 文 (使 用 REST 提取 仓库 信息 < a 
和 Streaming APII) 阅 提取 内 容 
从 [HTTP] 获 取 数 据 从 [HTTP] 获 取 数 据 从 [HTTP] 获 取 数 据 
， << 外 部 系统 >> ，<< 外 部 系统 >> ，<< 外 部 系统 >> 
' Twitter i 0 GitHub 和 1 博客 


se 


“技术 部 落 ”- 组 件 - 内 容 更 新 器 
独立 Java 进 程 


除了 一 些 核心 组 件 〈 稍 后 详 述 )， 独 立 的 内 容 更 新 需 进 程 由 以 下 组 件 构成 。 
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口 计划 内 容 更 新 器 : 该 组 件 安排 从 Twitter 、GitHub 和 博客 的 计划 ( 即 , 每 15 分 钟 ) 信息 更 
新 。 它 还 重新 计算 “最 近 活 跃 ”"， 每 小 时 发 放 一 次 徽章 奖励 。 它 是 一 个 使 用 Spring 调度 注 
释 的 Spring Bean。 代 码 请 看 je.techtribes.component.scheduledcontentupdater” 。 

口 Twitter 连接 器 : 该 组 件 负 责 连接 到 Twitter， 以 便 刷 新 档案 信息 和 取 回 微 博 。 它 是 一 个 使 
用 Twitter4J 类 库 2? 的 Spring Bean。REST2 和 Streaming API” 都 采用 了 。 代 码 请 看 
Je.techtribes.component. twitterconnector® 。 

口 GitHub 连接 器 : 该 组 件 负责 连接 到 GitHub， 以 便 刷 新 仓库 信息 。 它 是 一 个 使 用 Eclipse 

Mylyn GitHub 连接 器 "的 Spring Bean。 代 码 请 看 je.techtribes.component.githubconnector”。 

口 新 闻 订 阅 连 接 器 : 该 组 件 负 责 连 接 到 RSS/Atom 订阅 ,以便 刷 新 聚合 到 “技术 部 落 ” 网 站 
的 新 闻 和 博文 。 它 是 一 个 使 用 ROME 类 库 ” 的 Spring Bean。 代 码 请 看 je.techtribes. 


四 
component.newsfeedconnector 。 


组 件 : 核心 
下 图 展示 了 Web 服务 顺和 独立 的 内 容 更 新 需 共 用 的 通用 组 件 。 
这 是 对 每 个 核心 组 件 的 小 结 。 
口 内 容 源 组 件 : 该 组 件 提供 对 MySQL 中 存储 的 人 和 部 落 〈 合 指 “ 信 息 源 ”) 信息 的 访问 。 


代码 请 看 je.techtribes.component.contentsource" 。 

口 新 闻 订 阅 项 组 件 : 该 组 件 提供 对 MongoDB 中 存储 的 新 闻 和 博文 的 访问 。 代 码 请 看 
je.techtribes.component.newsfeedentry'. 上 

口 微 博 组 件 : 该 组 件 提供 对 MongoDB 中 存储 的 微 博 的 访问 。 代 码 请 看 je.techtribes. 
component.tweet®, 


口 讲座 组 件 : 该 组 件 提供 对 MySQL 中 存储 的 本 地 演讲 者 的 讲座 信息 的 访问 。 代 码 请 看 


GD https://github.com/techtribesje/techtribesje/tree/master/techtribes-updater/src/je/techtribes/component/scheduledcontentup 


dater 

http://twitter4j.org 

https://dev.twitter.com/docs/api。 一 一 译 者 注 
https://dev.twitter.com/docs/api/streaming。 一 一 译 者 注 


https://github.com/techtribesje/techtribesje/tree/master/techtribes-updater/src/je/techtribes/component/twitterconnector 
http://www.eclipse.org/mylyn/ 
https://github.com/techtribesje/techtribesje/tree/master/techtribes-updater/src/je/techtribes/component/githubconnector 
http://rometools.github.io/rome/ 


https://github.com/techtribesje/techtribesje/tree/master/techtribes-updater/src/je/techtribes/component/newsfeedconnector 


SACACNSISAISISISAY 


https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/contentsource 
DD https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/newsfeedentry 
@ https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/tweet 
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je.techtribes.component.talk”。 
口 活动 组 件 : 该 组 件 提供 对 MySQL 中 存储 的 本 地 活动 ( 比如 ， 聚 会 、 研 讨 会 、 代 码 道场 ， 
等 ) 信息 的 访问 。 代 码 请 看 je.techtribes.component.event”。 
口 工作 组 件 : 该 组 件 提 供 对 MySQL 中 存储 的 本 地 工作 机 会 信息 的 访问 。 代 码 请 看 
je.techtribes.component.job 。 
口 GitHub 组 件 : 该 组 件 提 供 对 MySQL 中 存储 的 属于 本 地 人 /部 落 的 代码 仓库 信息 的 访问 。 
代码 请 看 je.techtribes.component.github"。 
口 搜索 组 件 : 该 组 件 为 新 闻 、 博 文 和 微 博 提供 搜索 工具 。 使 用 Apache Lucene 进行 索引 和 搜 
索 。 代 码 请 看 je.techtribes.component.search® 。 
口 活跃 度 组 件 : 该 组 件 提 供 对 MySQL 中 存储 的 ， 内 容 更 新 器 计算 得 到 的 “最 近 活 跃 ” 信 息 
的 访问 。 代 码 请 看 je.techtribes.component.activity®。 
口 微 章 组 件 : 该 组 件 提供 对 人 /部 落 因 活跃 度 而 被 奖励 的 徽章 的 访问 。 代 码 请 看 
je.techtribes.component.badge” 。 
口 日 志 组 件 : 该 组 件 只 是 对 Commons Logging" 和 log4j 的 包装 。 所 有 其 他 组 件 都 会 使 用 它 。 
代码 请 看 je.techtribes.component.log”。 


QD https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/talk 

©® https://github.conm/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/event 

© https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/job 

(@ https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/github 

© https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/search 

(© https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/activity 

© https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/badge 

Commons Logging 提供 一 个 统一 的 日 志 接 口 ， 从 而 不 依赖 于 具体 的 日 志 实 现 ，http://commons.apache.org/proper/ 
ommons-logging/。 一 一 译 者 注 

© https://github.com/techtribesje/techtribesje/tree/master/techtribes-core/src/je/techtribes/component/log 
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<< 组 件 >> | 
活动 组 件 ， 
Spring 
Bean+JDBC， 提 
供 对 近期 活动 的 | 
评级 信息 的 访问 
并 计算 。 
pe 
使 用 
i i | 
<< 组 件 >> << 组 件 >> << 组 件 >> << 组 件 >> << 组 件 >> || << 组 件 >> << 组 件 >> << 组 件 >> 
事件 组 件 ， 新 闻 订 阅 入 口 组 | | ”演讲 组 件 ， 微 博 组 件 ， 徽章 组 件 ， GitHub 组 件 ， 工作 组 件 ， 搜索 组 件 ， 
Spring 件 ，Spring Bean Spring Spring Spring Spring Spring Spring 
Bean+JDBC， MongoDB, 提 | |Bean+JDBC， 提 | | Bean+Mongo Bean+JDBC， Bean+JDBC， 提 | | Bean+JDBC， Bean+Lucene， 
提供 对 本 地 事件 | 供 对 博客 文章 和 | | 供 对 本 地 演讲 者 | | DB， 提 供 对 微 | | 管理 已 授予 人 | | 供 对 与 内 容 源 相 | | 提供 对 最 近 发 | | 在 设备 中 搜索 
(比如 : 聚会 、 新 闻 的 访问 “| | 的 演讲 信息 的 访 博 的 访问 和 部 落 的 徽章 | | 关 的 GitHub 仓 || 布 的 工作 信息 | | 新 闻 订 阅 入 口 
用 户 组 ,等 ) 信 问 库 清单 的 访问 的 访问 和 微 博 
息 的 访问 | 
使 用 
v 
<< 组 件 >> << 组 件 >> 
内 容 源 组 件 ， 博客 组 件 ， 
Spring Spring 
Bean+Lucene， Bean+JDBC， 
在 设备 中 搜索 提供 对 人 和 部 落 
新 闻 订 阅 入 口 的 信息 的 访问 
和 微 博 
沽 被 所 有 组 件 使 用 x* 


“技术 部 落 ” 核 心 组 件 〈techtribes-corejar) 
AN /一 
基础 设施 架构 
这 个 部 分 提供 “技术 部 落 ” 网 站 的 基础 设施 架构 信息 。 


线 上 环境 
线 上 环境 非常 简单 ; 像 下 面 这 样 的 单个 托管 在 伦敦 地 区 的 Rackspace 云 服务 器 "。 


口 操作 系统 : Ubuntu 12.04 长 期 支持 版 ( Precise Pangolin” )。 
口 配置 1024 MB 内 存 ，40 GB 磁盘 。 
口 服务 器 类 型 : 下 一 代 服 务 器 。 


Rackspace 仪表 盘 的 凭据 是 : 


口 用 户 名 ， 六 六 六 六 闵 六 六 六 


QD http:/www.rackspace.com/cloud/servers/ 

@) 精准 的 穿山 甲 。Ubuntu 发 行 版 每 个 正式 版 本 的 代号 都 按 字母 表 顺 序 依次 以 动物 命名 。 如 12.04 为 Ubuntu 的 第 16 
个 正式 版 本 ， 在 字母 表 中 对 应 P， 因 此 选择 以 了 开头 的 动物 Pangolin 命名 。 一 一 译 者 注 

@) https://mycloud.rackspace.com 
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口 密码 ，。 六 六 六 六 六 闵 闵 冰 


部 署 


这 个 部 分 提供 软件 架构 和 基础 设施 架构 之 间 映 射 的 信息 。 


软件 


线 上 环境 是 单个 Rackspace 云 服 务 器 ,因此 下 列 所 有 软件 都 通过 Ubuntu 高 级 包 管理 工具 ( apt， 
Advanced Packaging Tool ) 安装 到 服务 需 。 


Twitter 的 认证 才能 工作 )。 
D Apache Tomcat 7。 

DD MySQL 5.x。 

口 MongoDB 2.2.x。 


构建 “技术 部 落 ” 


口 Java 7 ( OpenJDK" ) ( 这 需要 加 上 Java 加 密 扩 展 JCE 的 无 限 强度 管辖 政策 文件 ”， 通 过 


为 了 避免 “在 我 这 里 是 好 的 ”综合 症 ， 以 及 确保 构建 是 干净 的 和 可 重复 的 ， 所 有 发 布 都 由 一 


个 TeamCity 免费 版 的 持续 集成 服务 器 构建 。build.xml 


和 创建 发 布 包 等 繁重 的 工作 。 


法 本 " 完 


成 了 所 有 编译 、 运 行 自动 化 测试 


如 果 构 建成 功 ， 构 建 脚 本 的 最 后 一 部 分 ， 是 把 发 布 安全 地 复制 “技术 部 落 ” 的 Rackspace 服 


务 器 。 


GD Sun 公司 构建 的 Java 开发 环境 的 开源 版 本 。 一 一 译 者 注 
©® http:/www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html 


@) 一 款 持续 集成 工具 ,包括 服务 器 端 和 客 


su 
户 端 ， 


前 支持 Java 和 .NET 项 目 


(@ https://github.com/techtribesje/techtribesje/blob/master/build.xml 


开发 ,http://www.jetbrains.com/teamcity/。 
一 一 译 者 注 
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1. 编写 代码 ， 推 送 到 GitHub 
: 
GitHub : 
Te TeamCity a 二 


2. 编译 代码 ， 运 行 测试 ， 创 建 一 


个 发 布 ， 复 制 到 “技术 部 落 ” 3. deploy.sh < 构建 版 本 号 > 


部 署 “技术 部 落 ” 


“技术 部 落 ” 所 有 的 软件 都 安装 在 ~techtribesje/buiulds 目录 下 , 每 个 发 布 一 个 子 目录 ”。GitHub 


上 有 了 几 个 脚本 ”， 用 来 解压 一 个 发 布 ， 
部 署 一 个 新 版 本 ， 或 回 滚 到 一 个 | 


1 ~/bin/deploy.sh XYZ 


通过 symlinks 切换 版 本 ， 最 后 重启 进程 。 
日 版 本 ， 只 要 简单 运行 : 


(XYZ 是 TeamCity 持续 集成 服务 器 创建 的 构建 版 本 号 ) 


配置 


Web 服务 器 和 内 容 更 新 器 的 配置 文件 是 : +/etc/techtribesje-web.properties; + /etc/techtribesje- 


updater.properties。 


运营 和 支持 


这 个 部 分 提供 “技术 部 落 ” 网 站 运营 和 支持 方面 的 信息 。 


GD https://github.com/techtribesje/techtribesje/releases 
© https://github.com/techtribesje/techtribesje-bin 


@ 维护 符号 连接 的 工具 程序 。 一 一 译 者 注 
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启动 MySQL 
MySQL 是 作为 服务 安装 的 ， 应 该 在 服务 器 重启 后 运行 。 你 可 以 使 用 以 下 指令 检查 : 


1 sudo netstat -tap | grep mysql 
如 果 需 要 启动 MYSQL， 你 可 以 使 用 以 下 指令 : 


1 sudo service mysql start 


启动 MongoDB 


MongoDB 也 是 作为 服务 安装 的 ， 应 该 在 服务 顺 重 启 后 运行 。 你 可 以 使 用 以 下 指令 检查 : 


1 sudo netstat -tap | grep mongo 
2 tail /var/log/mongodb/mongodb.1og 


如 果 需 要 启动 MongoDB， 你 可 以 使 用 以 下 指令 : 


1 sudo service mongodb start 


启动 Web 服 务 器 
Apache Tomcat 也 是 作为 服务 安装 的 , 应 该 在 服务 器 重启 后 运行 。 你 可 以 使 用 以 下 指令 检查 : 


sh ps -Af | grep tomcat 
2 tail /var/lib/tomcat7/logs/catalina.out 


如 果 需 要 启动 Tomcat， 可 以 使 用 以 下 指令 : 


1 ~techtribesje/bin/start-tomcat.sh 
启动 内 容 更 新 器 


内 容 更 新 是 一 个 独立 的 Java 进程 ,需要 在 服务 右 重 启 后 手动 启动 ,你 可 以 使 用 以 下 指令 ( XYZ 
构建 版 本 号 ): 


1 ~techtribesje/bin/start-updater.sh XYZ 


你 可 以 使 用 以 下 指令 检查 : 


1 ~techtribesje/bin/updater-logs.sh XYZ 


监测 
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“技术 部 落 ” 网 站 唯一 的 监测 是 Pingdom*”"， 配 置 为 每 5 分 钟 测试 网 站 是 否 可 访问 。 一旦 发 现 
Web 服务 需 不 可 用 ， 就 会 发 送 电子 邮件 。 


备份 


格林 尼 治 标准 时 间 每 天 凌晨 3 点 , MySQL 和 MongoDB 数据 库 都 通过 计划 任务 进行 备份 。 你 
可 以 使 用 以 下 指令 检查 计划 任务 : 


1 crontab -1 
你 应 该 看 到 这 样 的 东西 : 
1 0 3 *** /home/techtribesje/bin/backup-data.sh > /dev/null 


这 个 shell 脚本 获取 MySQL 和 MongoDB 数据 库 的 导出 ， 复 制 到 一 个 与 Dropbox 同步 的 文 
件 夹 。 


GD https:/www.pingdom.com/ 
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“这 是 一 本 “指南 ”型 图 书 。 作 者 会 给 你 一 个 图 景 以 及 达到 它 的 关键 技术 指引 ， 你 可 以 得 到 一 个 思考 问题 
的 框架 ， 而 非 一 条 道路 或 一 套 方法 。 但 对 于 架构 师 来 说 ， 这 样 就 足够 了 。” 
周 爱 民 ， 现 任 吏 豆 莱 架 构 师 ， 前 盛大 网 络 平台 架构 师 、 支 付 宝 业务 架构 师 


软件 架构 在 成 功 的 软件 交付 中 扮演 着 重要 角色 ， 但 IT 行业 一 直 对 软件 架构 存在 误解 ， 缺 乏 应 有 的 重视 。 提 到 
软件 架构 ， 人 们 脑海 中 浮现 的 画面 通常 是 架构 师 闭门造车 ， 提 前 作 好 大 型 预 置 设计 ， 然 后 将 UML 模 型 或 数 百 页 客 
”_ 户 需求 文档 扔 给 毫 不 知情 的 开发 团队 。 很 多 组 织 也 将 软件 架构 看 作 一 种 职位 级 别 而 非 工 作 角 色 ， 甚 至 为 了 节省 成 
本 ， 将 编码 工作 外 包 ， 将 本 地 开发 人 员 推 上 “高 高 在 上 ”的 架构 师 职 位 。 种 种 现状 导致 软件 架构 与 编码 严重 脱 ， 
节 ， 也 致使 软件 架构 师 在 开发 人 员 群 体 中 名 声 不 佳 ， 被 视 为 脱离 实际 工作 、 只 会 画 框框 线 线 的 “指挥 家 ”。 其 
实 ， 下 至 接口 设计 ， 上 至 技术 选 型 ， 每 个 程序 员 多 多 少 少 都 接触 或 参与 过 一 些 架构 工作 ， 架 构 师 也 自然 而 然 成 为 
相当 一 部 分 程序 员 的 职业 发 展 方向 。 
本 书 从 全 新 的 视角 重新 解读 软件 架构 ， 揭 示 软 件 架 构 
的 本 质 ， 是 一 本 强调 实践 、 注 重 实效 、 轻 量 级 、 面 向 开发 
人 员 的 软件 架构 指南 。 本 书 作者 是 一 位 备 受 好 评 的 软件 架 
构 讲 师 ， 为 全 球 20 多 个 国家 的 软件 团队 提供 咨询 和 培训 ， 
其 中 不 乏 家 喻 户 晓 的 大 型 企业 。 在 过 去 几 年 中 ， 他 的 实践 
经 验 已 令 数 千 人 受益 终生 。 
如 果 你 是 一 名 软件 开发 人 员 ， 那 么 本 书 定 会 对 你 的 职 
业 发 展 有 所 助 益 。 
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